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TERMS AND CONDITIONS OF SALE AND LICENSE OF RADIO SHACK COMPUTER EQUIPMENT AND SOFTWARE 

PURCHASED FROM A RADIO SHACK COMPANY-OWNED COMPUTER CENTER, RETAIL STORE OR FROM A 

RADIO SHACK FRANCHISEE OR DEALER AT ITS AUTHORIZED LOCATION 






LIMITED WARRANTY 



CUSTOMER OBLIGATIONS 



A CUSTOMER assumes full responsibility that this Radio Shack computer hardware purchased (the "Equipment"), and any copies of Radio 
Shack software included with the Equipment or licensed separately (the "Software") meets the specifications, capacity, capabilities, 
versatility, and other requirements of CUSTOMER 

B CUSTOMER assumes full responsibility for the condition and effectiveness of the operating environment in which the Equipment and Software 
are to function, and for its installation 

II. RADIO SHACK LIMITED WARRANTIES AND CONDITIONS OF SALE 

A For a period of ninety (90) calendar days from the date of the Radio Shack sales document received upon purchase of the Equipment, RADIO 
SHACK warrants to the original CUSTOMER that the Equipment and the medium upon which the Software is stored is free from manufacturing 
defects THIS WARRANTY IS ONLY APPLICABLE TO PURCHASES OF RADIO SHACK EQUIPMENT BY THE ORIGINAL CUSTOMER FROM 
RADIO SHACK COMPANY-OWNED COMPUTER CENTERS, RETAIL STORES AND FROM RADIO SHACK FRANCHISEES AND DEALERS AT ITS 
AUTHORIZED LOCATION The warranty is void if the Equipment's case or cabinet has been opened, or if the Equipment or Software has been 
subjected to improper or abnormal use If a manufacturing defect is discovered during the stated warranty period, the defective Equipment 
must be returned to a Radio Shack Computer Center, a Radio Shack retail store, participating Radio Shack franchisee or Radio Shack dealer 
for repair, along with a copy of the sales document or lease agreement The original CUSTOMER'S sole and exclusive remedy in the event of 
a defect is limited to the correction of the defect by repair, replacement, or refund of the purchase price, at RADIO SHACK'S election and sole 
expense. RADIO SHACK has no obligation to replace or repair expendable items 

B RADIO SHACK makes no warranty as to the design, capability, capacity, or suitability for use of the Software, except as provided in this 
paragraph Software is licensed on an "AS IS" basis, without warranty The original CUSTOMER'S exclusive remedy, in the event of a 
Software manufacturing defect, is its repair or replacement within thirty (30) calendar days of the date of the Radio Shack sales document 
received upon license of the Software The defective Software shall be returned to a Radio Shack Computer Center, a Radio Shack retail store, 
participating Radio Shack franchisee or Radio Shack dealer along with the sales document 

C Except as provided herein no employee, agent, franchisee, dealer or other person is authorized to give any warranties of any nature on behalf 
of RADIO SHACK 

D Except as provided herein, RADIO SHACK MAKES NO WARRANTIES, INCLUDING WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A 
PARTICULAR PURPOSE. 

E Some states do not allow limitations on how long an implied warranty lasts, so the above limitation(s) may not apply to CUSTOMER 



III. LIMITATION OF LIABILITY 
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A EXCEPT AS PROVIDED HEREIN, RADIO SHACK SHALL HAVE NO LIABILITY OR RESPONSIBILITY TO CUSTOMER OR ANY OTHER PERSON 
OR ENTITY WITH RESPECT TO ANY LIABILITY, LOSS OR DAMAGE CAUSED OR ALLEGED TO BE CAUSED DIRECTLY OR INDIRECTLY BY 
"EQUIPMENT" OR "SOFTWARE" SOLD, LEASED, LICENSED OR FURNISHED BY RADIO SHACK, INCLUDING, BUT NOT LIMITED TO, ANY 
INTERRUPTION OF SERVICE, LOSS OF BUSINESS OR ANTICIPATORY PROFITS OR CONSEQUENTIAL DAMAGES RESULTING FROM THE 
USE OR OPERATION OF THE "EQUIPMENT" OR "SOFTWARE". IN NO EVENT SHALL RADIO SHACK BE LIABLE FOR LOSS OF PROFITS, OR 
ANY INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY BREACH OF THIS WARRANTY OR IN ANY MANNER 
ARISING OUT OF OR CONNECTED WITH THE SALE, LEASE, LICENSE, USE OR ANTICIPATED USE OF THE "EQUIPMENT" OR "SOFTWARE" 

NOTWITHSTANDING THE ABOVE LIMITATIONS AND WARRANTIES, RADIO SHACK'S LIABILITY HEREUNDER FOR DAMAGES INCURRED BY 

CUSTOMER OR OTHERS SHALL NOT EXCEED THE AMOUNT PAID BY CUSTOMER FOR THE PARTICULAR "EQUIPMENT" OR "SOFTWARE" 

INVOLVED. 
B RADIO SHACK shall not be liable for any damages caused by delay in delivering or furnishing Equipment and/or Software 
C No action arising out of any claimed breach of this Warranty or transactions under this Warranty may be brought more than two (2) years 

after the cause of action has accrued or more than four (4) years after the date of the Radio Shack sales document for the Equipment or 

Software, whichever first occurs 
D Some states do not allow the limitation or exclusion of incidental or consequential damages, so the above limitation(s) or exclusion(s) may 

not apply to CUSTOMER 

IV. RADIO SHACK SOFTWARE LICENSE 

RADIO SHACK grants to CUSTOMER a non-exclusive, paid-up license to use the RADIO SHACK Software on one computer, subject to the following 

provisions: 

A Except as otherwise provided in this Software License, applicable copyright laws shall apply to the Software 

B Title to the medium on which the Software is recorded (cassette and/or diskette) or stored (ROM) is transferred to CUSTOMER, but not title to 

the Software 
C • CUSTOMER may use Software on one host computer and access that Software through one or more terminals if the Software permits this 

function. 
D CUSTOMER shall not use, make, manufacture, or reproduce copies of Software except for use on one computer and as is specifically 

provided in this Software License Customer is expressly prohibited from disassembling the Software 
E CUSTOMER is permitted to make additional copies of the Software only for backup or archival purposes or if additional copies are required in 

the operation of one computer with the Software, but only to the extent the Software allows a backup copy to be made However, for 

TRSDOS Software, CUSTOMER is permitted to make a limited number of additional copies for CUSTOMER'S own use 
F CUSTOMER may resell or distribute unmodified copies of the Software provided CUSTOMER has purchased one copy of the Software for each 

one sold or distributed The provisions of this Software License shall also be applicable to third parties receiving copies of the Software from 

CUSTOMER 
G. All copyright notices shall be retained on all copies of the Software 

V. APPLICABILITY OF WARRANTY 

A The terms and conditions of this Warranty are applicable as between RADIO SHACK and CUSTOMER to either a sale of the Equipment and/or 
Software License to CUSTOMER or to a transaction whereby RADIO SHACK sells or conveys such Equipment to a third party for lease to 
CUSTOMER 

B The limitations of liability and Warranty provisions herein shall inure to the benefit of RADIO SHACK, the author, owner and/or licensor of the 
Software and any manufacturer of the Equipment sold by RADIO SHACK 



VI. STATE LAW RIGHTS 

The warranties granted herein give the original CUSTOMER specific I 
from state to state 



rights, and the original CUSTOMER may have other rights which vary 
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IMPORTANT NOTICE 



This Technical Reference Manual is written for owners of the TRS-80 Model 4 
Computer, who have a thorough understanding of electronics and computer circuitry. 
It is not written to the beginner's level of comprehension. 

This manual contains detailed schematics and theories of operation for each major part 
of the Model 4. These tools will aid you with designing interfaces for your computer, 
repairing your own computer after its warranty has expired, or simply obtaining 
practical knowledge of your TRS-80 Model 4 operation. 

Radio Shack will not be liable for any damage caused, or alleged to be caused, by the 
customer or any other person using this technical manual to repair, modify, or alter 
the TRS-80 Model 4 Computer in any manner. 

Many parts of the computer electronics are very sensitive and can be easily damaged 
by improper servicing. We strongly suggest that for proper servicing, the computer be 
returned to Radio Shack. 

Because of the sensitivity of computer equipment and the potential problems which 
can result from improper servicing, the following limitations apply to services offered 
by Radio Shack: 

1. If any of the warranty seals on any Radio Shack computer product are broken. 
Radio Shack reserves the right to refuse to service the equipment or to void any 
remaining warranty on the equipment. 

2. If any Radio Shack computer product has been modified so that it is not within 
manufacturer's specifications, including, but not limited to, the installation 

of any non-Radio Shack parts, components, or replacement boards, then Radio 
Shack reserves the right to refuse to service the equipment, void any remaining 
warranty, remove and replace any non-Radio Shack part found in the equipment, 
and perform whatever modifications are necessary to return the equipment to 
original factory specifications. 

3. The cost for the labor and parts required to return the Radio Shack computer 
equipment to its original specifications will be charged to the customer in addition 
to the normal repair charges. 
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1.1 SYSTEM OVERVIEW 

The Radio Shack TRS-80 Model 4 Microcomputer is an enhanced version of Radio Shack's popular TRS-80 Model III 
Microcomputer. The TRS-80 Model 4 is software compatible with the Model III so that owners of either system can take 
advantage of the large number of programs available. 

Features of the TRS-80 Model 4 which are common to the TRS-80 Model III include: 

• Availability of Level I or Level II BASIC in ROM 

• Full size typewriter style keyboard 

• A 12-inch video display 

• Built-in cassette interface 

• Character display of 1 6 lines of 64 characters 

• Graphics under control of BASIC (128 H x 48 V) 

• UL recognized construction 

• 1 2-key numeric keypad for rapid entry of numbers 

• Rugged cabinet housing keyboard , electronics, video display, and power supply 

• Direct drive video monitor for improved resolution 

• Internal power supply 

• Parallel printer port for use with Radio Shack printers 

Other features available when Level II BASIC is used are: real time clock, upper and lower case characters, RAM internally 
expandable to 128K bytes, I/O port for peripheral expansion, and cassette interface available with 500 and 1500 baud 
rates. 

Optional peripherals for the TRS-80 Model 4 include disk drives (two built-in, two external) with double density for 
increased storage capacity, and a built-in RS-232 serial interface for communications and peripheral interface. 

1.2 BLOCK DIAGRAM 

The Block Diagram (Figure 1-1) shows the various internal components and connections of the Model 4 Microcomputer. 
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FIGURE 1-1. TRS-80 MODEL 4 INTERCONNECTION DIAGRAM 



1.3 JUMPER OPTIONS 
1.3.1 16Kto64K 

1. Remove U77 - U84 

2. Move E5-E6 to E5-E4 
Move E1-E2to E2-E3 
MoveE12-E13to E12-E11 

3. Add E7-E8 and eight Tandy #8040665 ICs in locations 
U77-U84. 

4. Remove capacitors C68, C72, C76, C80, C84, C88, 
C92 and C96. 

1.3.2 64Kto128K 

1. Remove shunt at U72 and add IC Tandy #8075468 in 
its place. 

2. Add eight Tandy #8040665 ICs in locations U85-U92. 

1.3.3 Graphics Board 

1. Remove E14-E15 (and screws near U65 and U71). 

2. Plug in Graphics Board 

3. Replace mounting screws at U65 and U7 1 . 

1.3.4 E9-E10 are not used at this time 



SECTION II 



ISASSEHBLY/ASSEHBLY 



DISASSEfyiBLY/ASSI 



2.1 DISASSEMBLY 



2.1.1 Case 

1 . Remove all cables from the bottom and rear of the Com- 
puter. Position the Computer on its rear panel to provide 
easy access to the case bottom. Remove the ten screws 
from the case bottom. Notice the different types and 
lengths of screws and note their positions. Set them 
aside in groups. 

2. Position the Computer upright and remove the #6 screw 
and washer from the top of the back panel of the case . 

3. Very carefully remove case top, lifting straight up and 
setting it aside to the left (if facing video screen). Be 
careful not to exceed the length of the video cable. 

4. Remove screws from the chassis shield and the ground 
connectors and remove the shield. ** 

2.1.2 CPU Board 

1. Remove the six screws which attach the RFI Rear 
Shield to the metal CPU mounting bracket. This bracket 
is also held in place with tape at the lower part of the 
bracket. Carefully peel the tape away from the shield 
so that it may be reused. 

2. Remove all cables connecting the CPU Board (power 
supply cable, video, keyboard, and cassette cables, and 
if applicable, the RS-232, sound board, and FDC inter- 
connect cables). 

3. Remove the eight screws fastening the CPU PCB (three 
at the top and bottom and one on either side of the 
board in the middle. 

4. Make sure all cables to the CPU Board have been discon- 
nected then remove the Board. (If your unit uses plastic 
spacer mounts to hold the Board, press the small tabs on 
the mounts through the mounting holes in the PCB and 
gently pull the CPU Board off.) 



2.1.4 RS-232 Board (optional) 

NOTE: The CPU Board must be removed before removing 
the RS-232 Board. 

1 , Be sure to remove all cables connecting the RS-232 
Board, 

2. Remove the screws connecting the PC Board to the 
chassis and remove the Board . 

2.1.5 Main Power Supplies 

Three different power supplies are used on the Model 4 
Computer, depending on the initial configuration of the unit. 
If the unit is supplied with 16K RAM and cassette input, 
Power Supply Assembly #8790021 is supplied to provide 
DC voltages required to power the computer. It is mounted 
on the front side of the main CPU mounting bracket at the 
rear of the unit. If disk drive(s) are added to this computer, 
a second power supply is mounted to the LH disk drive 
mounting bracket. 

If the computer is supplied with 64K RAM and a single, or 
dual disk drive, then power supply #8790043 or #8790049 
is supplied to power the unit. This power supply is mounted 
at the left side of the LH disk drive mounting bracket. It is 
attached to the CPU mounting bracket by screws through 
the heat sink bracket of the power supply. 

1. Remove all interconnecting cables to the board(s). These 
include the power supply cable, video, keyboard, and 
cassette cable. If applicable, also remove the RS-232 
and FDC power connectors and the disk ribbon cable. 

2. Note the position of the ground tab and remove it. 

3. Remove the screws which attach the power supply to 
its mounting support (four for the 38W power supply 
and two for the 65W power supplies). Spacers separate 
the 38W power supply from its mounting bracket. 

The 65W power supply is provided with insulated 
standoffs to prevent shorting the power supply against 
the metal disk drive shield bracket. 



2.1.3 FDC Board (optional) 

NOTE: The CPU Board must be removed before removing 
the FDC Board. 

1. Be sure to disconnect all cables to the FDC Board. 

2. Remove the screws holding the FDC Board to the metal 
chassis and remove the Board. 

**Not applicable to all units. 



4. Carefully lift the power supply out of the computer. If 
the unit is one which has been upgraded to include 
a disk drive and is equipped with two power supplies, 
it may be necessary to remove the Main CPU mounting 
bracket to provide access to the mounting screws of 
one of the power supplies. 

2.1.6 Disk Drives (optional) 

1. To remove the Disk Drive in the top position, carefully 
remove the FDC inter-connect cable connected to the 
rear of the Drive. 



2. Remove the four screws and washers (two on each side) 
which connect the Drive to the Disk Mounting Bracket. 
Remove the RFI shield which covers the top drive. 

3. Disconnect the power supply connector from the bot- 
tom of the top board in the Disk Drive and also remove 
the ground wire from the rear of the Drive 



known good ground and connect the other end of the 
wire to the blade of a common screwdriver. Insert the 
screwdriver blade under the suction cup and touch it 
to the clip holding the wire to the CRT. 



4. To remove the Disk Drive in the bottom position, you 
must first remove the Power Supply attached to the 
LH Disk Mounting bracket to gain access to the Disk 
Drive mounting screws. 

5. After removing the Power Supply, remove the FDC 
inter-connect cable from the rear of the Drive. 



3. Insert a common screwdriver under the suction cup on 
the high-voltage anode wire on the side of the CRT. Use 
the screwdriver to compress the clip holding the wire to 
the tube and pull the wire free. 

4. Remove the ground wire fastened directly to the Video 
Board. 



6. Remove the four screws and washers (two on each side) 
which connect the Drive to the Disk Mounting Bracket. 

7. Disconnect the power supply connector from the bot- 
tom of the top board in the Disk Drive and also remove 
the ground wire from the rear of the Drive. 

2.1.7 Video Monitor (CRT) and Video Board 

1. Disconnect the four color coded wires with spade lugs 
from the CRT yoke. (Be sure to note their positions.) 

2. Disconnect the connector on the rear of the CRT neck. 

WARNING 



5. Remove the upper right and lower left nuts and washers 
which hold the CRT in place. 



CAUTION 

If dropped, the CRT may implode. To avoid this kind of 
accident, support the CRT while performing the next 
step, 

6. Remove the remaining lower right and upper left nuts, 
and washers and carefully remove the CRT. 

7. Disconnect the CPU cable connector from the Video 
Board. 



There may be a high voltage charge on the high voltage 
anode. To discharge, connect one end of a wire to a 



8. Remove the two screws fastening the Video Board to the 
Case Top and carefully lift out Board. 
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2.2 ASSEMBLY 

2.2.1 RS-232 Board (optional) 

1. Install the PC Board using #6 x 1/4" screws. If appli- 
cable, press the PC Board onto the plastic spacer mounts 
then fasten with the screws, 

2. Reconnect all cables to the RS-232 Board. 

2.2.2 FDC Board (optional) 

1. Install the PC Board using #6 x 1/4" screws and the 
plastic spacer mounts, if used. 

2. Reconnect all cables to the FDC Board . 

2.2.3 CPU Board 

1. Make sure good insulating washers are attached to the 
CPU Board then fasten the Board using #6 x 1/2" 
screws. 

2. Reconnect all cables to the CPU Board (power supply 
cable, video, keyboard, and cassette cables, and if appli- 
cable, RS-232, sound board, and FDC inter-connect 
cables). 

3. Attach the small PCB Mount Bracket (if used) to the 
metal chassis bracket with two #6 x 1/4" screws. 

2.2.4 Power Supply 

1. Fasten the Power Supply to the CPU chassis bracket 
using #6 x 1/4" screws. Be sure the ground tab is 
fastened back in place. 

2. Reconnect all cables (power supply, video, keyboard, 
and cassette cables, and RS-232 and FDC power cables 
and Disk ribbon cable if necessary). 

2.2.5 Disk Drive (optional) 

1. Place the Disk Drive in the bottom position and recon- 
nect the ground wire and power supply connector. 

2. Fasten the Drive with four #6-32 x 1/2" screws and four 
flat washers (two on each side). 

3. Reconnect the FDC inter-connect cable to the rear of 
the Drive. 

4. Position the second Disk Drive in the top position and 
reconnect the ground wire and power supply connector. 

5. Fasten with four screws and washers (two on each side). 

6. Reconnect the FDC inter-connect cable to the rear of 
the Drive. 



2.2.6 Disk Drive Power Supply (optional) 

1. Before installing the Power Supply, be sure that the 
bottom Disk Drive is mounted in place and the Disk 
Shield is in position on the Disk Mounting Bracket. 

2. Reconnect all cables and wires to the Power Supply. 

3. Fasten the Power Supply with four #6 x 3/8" screws. 
Be sure the ground tab is fastened back in place 

2.2.7 Video Monitor (CRT) and Video Board 

1. Position the CRT in the Case Top and install the upper 
left and lower right —10 washers and nuts. 

2. Install the upper right and lower left #10 washers and 
nuts. Be sure to reconnect the ground wire from the 
CPU cable. It will require two nuts to fasten it. 

3. Install the Video Board into the Case and fasten with 
two #6 x 3/8" screws. 

4. Connect the ground wire with solder lug back to the 
Video Board. 

5. Install the plug on the rear of the CRT neck. 

6. Install the four color coded wires with spade lugs to 
their associated terminals (as determined by a colored 
dot on the yoke near each terminal). 

7. Install the high-voltage anode wire on the side of the 
CRT. Use a screwdriver to compress the clip and insert 
it into the CRT. Press down on the suction cup to 
secure. 

2.2.8 Case 

1. Double-check to be sure all wires are connected cor- 
rectly and all Boards are properly fastened. 

2. Attach the chassis shield (if used) with #6 x 1/4" 
screws and reconnect the ground connectors. 

3. Carefully place the Case Top over the Case Bottom. 
Do not hit the CRT neck. It could implode or break 
off. 

4. Install the #6 x 3/8" sheet metal screw and flat washer 
in the top rear panel of the Case. 

5. Carefully rest the Computer on its rear panel and replace 
the ten #8 screws; five 1" sheet metal toward rear, three 
7/8" machine head along front, and two 1" machine 
head in remaining positions. 
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3.1 MODEL 4 THEORY OF OPERATION 



3.1.1 Introduction 

The TRS-80 Model 4 Microcomputer is a self-contained 
desktop microcomputer designed not only to be completely 
software compatible with the TRS-80 Model III, but to pro- 
vide many enhancements and features. System distinctions 
which enable the Model 4 to be Model III compatible 
include: a Z80 CPU capable of running at a 4 MHz clock 
rate, BASIC operating system in ROM (14K), memory- 
mapped keyboard, 64-character by 16-line memory -mapped 
video display, up to 128K Random Access Memory, cassette 
circuitry able to operate at 500 or 1500 baud, and the 
ability to accept a variety of options. These options include: 
one to four 5-1/4 inch double density floppy disk drives, one 
to four five megabyte hard disk drives, an RS-232 Serial 
Communications Interface, and a 640 by 240 pixel high 
resolution graphics board. 

3.1.2 CPU and Timing 

The central processing unit of the Model 4 microcomputer 
is the Z80-A microprocessor — capable of running at either 
a two (2.02752) or four (4.05504) MHz clock rate. The main 
CPU timing comes from the 20 MHz (20.2752 MHz) crystal- 
controlled oscillator, Y1 and Q1. There is an additional 
12 MHz (12.672 MHz) oscillator, Y2 and Q2, which is 
necessary for the 80 by 24 mode of video operation. The 
oscillator outputs are sent to two Programmable Array 
Logic (PAL) circuits, U3 and U4, for frequency division 
and routing of appropriate timing signals. 

PAL U3 divides the 20 MHz signal by five for 4 MHz CPU 
operation, by ten for a 2 MHz rate, and slows the 4 MHz 
clock for the M1 Cycle (See Figure 3-3). U3 also divides 
the master clock by four to obtain a 5 MHz clock to be sent 
to the RS-232 option connector as a reference for the baud 
rate generator. PAL U4 selects an appropriate 10 MHz or 
12 MHz clock for the video shift clock, and using divider 
U5 provides additional timing signals to the video display 
circuitry (See Fig. 3-4). 

Hex latch U18 is clocked from the 20 MHz clock, and is 
used to provide MUX and CAS timing for the dynamic 



Port Addr. (Hex) 



Read Function 



memory circuits. Also, with additional gates from U16, 
U19, U20, U31, and U32, this chip provides the wait cir- 
cuitry necessary to prevent the CPU from accessing video 
RAM during the active portion of the display. This is done 
by latching the data for the video RAM and simultaneously 
forcing the Z80 CPU into a "WAIT" state and is necessary 
to eliminate undesirable "hashing" of the video display 
(See Fig. 3-4). 

3.1.3 Buffering 

Low level signals from and to the CPU need to be buffered, 
or current amplified in order to drive many other circuits. 
The 16 address lines are buffered by U55 and U56, which are 
unidirectional buffers that are permanently enabled. The 
eight data lines are buffered by U71. Since data must flow 
both to and from the CPU, U71 is a bidirectional buffer 
which can go into a three-state condition when not in use. 
Both direction and enable controls come from the address 
decoding section. 

The clock signal to the CPU (from PAL U3) is buffered by 
active pullup circuit Q3 RESET and WAIT inputs to the 
CPU are buffered by U17 and U46. Control outputs from 
the Z80 (M1*, RD*, WR*, MREQ*, and IORQ*) are sent 
to PAL U58, which combines these into other appropriate 
control signals consistent with Model 4's architecture. Other 
than MREQ*, which is buffered by part of U38, the raw 
control signals go to no other components, and hence require 
no additional buffering. 

3.1.4 Address Decoding 

The address decoding section is divided into two sub- 
sections: Port address decoding and Memory address 
decoding. 

In port address decoding, low order address lines (some 
combined through a portion of U32) are sent to the address 
and enable inputs of U48, U49, and U50. U48 is also enabled 
by the IN* signal, which means that is decodes port input 
signals, while U49 decodes port output signals. A table of 
the resulting port map is shown below: 

Write Function 



FC-FF 





F8- 


FB 


(1) 


F4- 


F7 


(1) 


F3 




(1) 


F2 




(1) 


F1 





Cassette In, Mode Read 

Read Printer Status 
- reserved - 
FDC Data Reg. 
F DC Sector Reg. 
FDC Track Reg. 



Cassette Out, resets 
cassette data latch 
Output to Printer 
Drive Select latch 
FDC Data Reg. 
FDC Sector Reg. 
FDC Track Reg. 
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FIGURE 3-1. MODEL 4 BLOCK DIAGRAM 
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(1) F0 




EC- 


■EF 


(2) EB 




(2) EA 




(2) E9 




(2) E8 




E4- 


E7 


EO- 


E3 


(3) CF 




(3) CE 




(3) CD 




(3) CC 




(3) CB 




(3) CA 




(3) C9 




(3) C8 




(3) C7 




(3) C6 




(3) C5 




(3) C4 




(3) C2- 


C3 


(3) C1 




(3) CO 




94- 


9F 


(4) 90- 


93 


(5) 8C- 


8F 


8B 




8A 




89 




88 




84- 


87 


(5) 83 




(5) 82 




(5) 81 




(5) 80 





FDC Status Reg. 
Resets RTC Int. 
Rcvr Holding Reg. 
UART Status Reg. 

- reserved - 
Modem Status 

Read NMI Status 
Read I NT Status 
H D Status 
HDSize/Drv/Hd 
HD Cylinder high 
HD Cylinder low 
HD Sector Number 
HD Sector Count 
HD Error Reg. 
HD Data Reg. 
HDCTC channel 3 
HDCTC channel 2 
HDCTC channel 1 
HDCTC channel 
HD Device ID Reg. 
HD Control Reg. 
HD Wr. Prot. Reg. 

- reserved - 

- reserved - 
Graphics Sel. 2 
CRTC Data Reg. 
CRTC Control Reg. 
CRTC Data Reg. 
CRTC Control Reg. 

- reserved - 

- reserved - 

- reserved - 
Graphics Ram Rd. 

- reserved - 



FDC Command Reg. 
Mode Output latch 
Xmit Holding Reg. 
UART/Modem control 
Baud Rate Register 
Master Reset/Enable 
UART control reg. 
Write NMI Mask reg. 
Write INT Mask reg. 
HD Command 
HD Size/Drv/Hd 
HD Cylinder high 
HD Cylinder low 
HD Sector Number 
HD Sector Count 
HD Write Precomp. 
HD Data Reg. 
HDCTC channel 3 
HD CTC channel 2 
HDCTC channel 1 
HDCTC channel 

- reserved - 

HD Control Reg. 

- reserved - 

- reserved - 
Sound Option 
Graphics Sel. 2 
CRTC Data Reg. 
CRTC Control Reg. 
CRTC Data Reg. 
CRTC Control Reg. 
Options Register 
Gra. X Reg. Write 
Gra. Y Reg. Write 
Graphics Ram Wr. 
Gra. Options Reg. Wr 



Notes: (1) Valid only if FDC option is installed 

(2) Valid only if RS-232 option is installed 

(3) Valid only if Hard Disk option is installed 

(4) Valid only if sound option is installed 

(5) Valid only if High Resolution Graphics option is installed 
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Following is a Bit Map of the appropriate ports in the Model 4. Note that this is an "internal" bit map only. For bit maps of the 
optional devices, refer to the appropriate section of the desired manual. 



Port 


D7 


FC-FF 


Cass 


(READ) 


data 




500 bd 


FC-FF 




(WRITE) 


X 


F8- FB 


Prntr 


(READ) 


BUSY 


F8-FB 


Prntr 


(WRITE) 


D7 



D6 



Prntr 
Paper 

Prntr 
D6 



Model 4 Port Bit Map 
D5 D4 D3 

(MIRROR of PORT EC 
(Note, also resets cassette data latch) 



Prntr 
Select 

Prntr 
D5 



Prntr 
Fault 

Prntr 
D4 



x 
x 

Prntr 
D3 



D2 



x 
x 

Prntr 
D2 



D1 



out 

X 
X 

Prntr 
D1 



DO 

Cassette 

data 
1 500 bd 

cassette 

data out 

x 
x 

Prntr 
DO 



EC-EF 



(Any Read causes reset of Real Time Clock Interrupt) 



EC-EF 


X 


CPU 


x 


Enable 


Enable 


Mode 


Cass 


X 


(WRITE) 


X 


Fast 


X 


EX I/O 


Altset 


Select 


Mot On 


X 


E0-E3 


X 


Receive 


Receive 


Xmit 


10 Bus 


RTC 


C Fall 


C Rise 


(READ) 


X 


Error 


Data 


Empty 


Int 


Int 


Int 


Int 


E0-E3 


X 


Enable 


Enable 


Enable 


Enable 


Enable 


Enable 


Enable 


(WRITE) 


X 


Rec Err 


Rec Data 


Xmit Emp 


10 Int 


RT Int 


CF Int 


CR Int 


90-93 


X 


X 


X 


X 


X 


X 


X 


Sound 


(WRITE) 


X 


X 


X 


X 


X 


X 


X 


Bit 


84-87 


Page 


Fix Upr 


Memory 


Memory 


Invert 


80/64 


Select 


Select 


(WRITE) 




Memory 


Bit 1 


BitO 


Video 




Bit 1 


BitO 



Memory mapping is accomplished by PAL U59 in the Basic 16K or 64K computer. In a 128K system, PAL U72, along with the 
select and memory bits of the options register, also enter into the memory mapping function. 

Four memory maps are listed below. Memory Map I is compatible with the Model III. Note that there are two 32K banks in the 
64K system, which can be interchanged with either position of the upper two banks of a 128K system. The 128K system has 
four moveable 32K banks. Also note, in the Model III mode, that decoding for the printer status read (37E8 and 37E9 hexadeci- 
mal) is accomplished by U93 and leftover gates from U40, U46, U51, U54, U60, and U62. 

Memory Map I - Model 111 Mode 



0000- 1FFF 
2000-2FFF 
3000- 37 FF 
37E8-37E9 
3800-3BFF 
3C00-3FFF 
4000-7FFF 
4000- FFFF 



ROM A(8K) 

ROM B (4K) 

ROM C (2K) - Less 37E8 - 37E9 

Printer Status Port 

Keyboard 

Video RAM (Page bit selects 1 K of 2I<) 

RAM (16K system) 

RAM (64K system) 
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Memory Map II 



0000-37FF 
3800-3BFF 
3C00-3FFF 
4000-7FFF 

8000 -FFFF 



0000-7FFFF 

8000-F3FF 
F400- F7FF 
F800- FFFF 



RAM (14K) 
Keyboard 
Video RAM 
RAM (16K) 

RAM (32K) 

Memory Map III 

RAM (32K) 

RAM (29K) 
Keyboard 
Video RAM 



End of one32K Bank 
Second 32K Bank 

End of One32K Bank 
Second 32K Bank 



3.1.5 ROM 



0000-7FFF 
8000 -FFFF 



Memory Map IV 

RAM (32K) 
RAM (32K) 



One32K Bank 
Second 32K Bank 



(See Figure 3-2 for 128K Maps) 



The Model 4 Microcomputer contains 14K of Read Only 
Memory (ROM), which is divided into an 8K ROM (U68), a 
4K ROM (U69), and a 2K ROM (U70). ROMs used have 
three-state outputs which are disabled if the ROMs are 
deselected. As a result, ROM data outputs are connected 
directly to the CPU data bus and do not use data buffer 
U71, which is disabled during a ROM access. 

ROMs are Model III compatible and contain a BASIC opera- 
ting system, as well as a floppy disk boot routine. The enable 
inputs to the ROMs are provided by the address decoding 
section, and are present only in the Model III mode of 
operation. 

3.1.6 RAM 

Three configurations of Random Access Memory are avail- 
able on the Model 4: 16K, 64K, and 128K. The 16K option 
uses 4116 type, 16K by 1 dynamic RAMs, which require 
three supply voltages (+12 volts, +5 volts, and -5 volts). 
The 64K and 128K options use 6665 type, 64K by 1 dyna- 
mic RAMs, which require only a single supply voltage (+5 
volts). The proper voltage for each option is provided by 
jumpers. 

Dynamic RAMs require multiplexed incoming address lines. 
This is accomplished by ICs U63 and U76. Output data 
from RAMs is buffered by U64. With the 128K option, there 
are two rows of the 64K by 1 RAM ICs. The proper row is 
selected by the CAS* signal from PAL U72. 



3.1.7 Keyboard 

The Model 4 Keyboard is a 70-key sculptured keyboard, 
scanned by the microprocessor. Each key is identified by 
its column and row position. Columns are defined by address 
lines AO - A7, which are buffered by open-collector drivers 
U29 and U30. Data lines DO - D7 define the rows and are 
buffered by CMOS buffers U44 and U45. Row inputs to the 
buffers are pulled up by resistor pack RP 1, unless a key 
in the current column being scanned is depressed. Then, 
the row for that key goes low. 

3.1.8 Video 

The heart of the video display circuitry in the Model 4 is 
the 68045 Cathode Ray Tube Controller. The CRTC allows 
two screen formats: 64 by 16 and 80 by 24. Since the 80 
by 24 screen requires 1,920 screen memory locations, a 
2K by 8 static RAM is used for the Video RAM. The 64 
by 16 mode has a two-page screen display and a bit in the 
options register for determining which page is active for 
the CPU. Offset the start address of the CRTC to gain 
access to the second page in the 64 by 16 mode. 

Addresses to the video RAM are provided by the 68045 
when refreshing the screen and by the CPU when updating 
the data. These two sets of addresses are multiplexed by 
U33, U34, and U35. Data between the CPU and Video 
RAM is latched by U6 for a write, and buffered by U7 for 
a read operation. 
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SYSTEM 
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KEYBOARD (IK) 
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(NOTE 2K VIDEO RAM! 
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FIGURE 3-2. RAM MEMORY 
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During screen refresh, the data outputs of the Video RAM 
(ASCII character codes) are latched by U8 and become the 
addresses for the character generator ROM (U23). In cases 
of low resolution graphics, a dual 1 of 4 data selector (U9) 
is the cell generator, with additional buffering from U10 

The shift register U11 inputs are the latched data outputs 
of the character or cell generator. The shift clock input 
comes from the PAL U4, and is 10.1376 MHz for the 64 
by 16 mode and 12.672 MHz for 80 by 24 operation. The 
serial output from the shift register later becomes actual 
video dot information. 

Special timing in the video circuit is handled by hex latch 
U2. This includes blanking (originating from CRTC) and 
shift register loading (originating from U4). Additional 
video control and timing functions, such as sync buffering, 
inversion selection, dot clock chopping, and graphics disable 
of normal video, are handled by miscellaneous gates in U12, 
U13, U14, U22, U24, and U26. 

3.1.9 Real Time Clock 

The Real Time Clock circuit in the Model 4 provides a 30 
Hz (in the 2 MHz CPU Mode) or 60 Hz (in the 4 MHz CPU 
Mode) interrupt to the CPU. By counting the number of 
interrupts that have occured, the CPU can keep track of the 
time. The 60 Hz vertical sync signal from the video circuitry 
is divided by two (2 MHz Mode) by U53, and the 30 Hz at 
pin 1 of U51 is used to generate the interrupts. In the 4 
MHz mode, signal FAST places a logic low at pin 1 of U51, 
causing signal VSYNC to trigger the interrupts at the 60 Hz 
rate. Note that any time interrupts are disabled, the accuracy 
of the clock suffers. 

3.1.10 Cassette Circuitry 

The cassette write circuitry latches the two LSBs (DO and 
D1) for any output to port FF (hex). The outputs of these 
latches (U27) are then resistor summed to provide three 
discrete voltage levels (500 Baud only). The firmware toggles 
the bits to provide an output signal of the desired frequency 
at the summing node. 

There are two types of cassette Read circuits — 500 baud and 
1500 baud. The 500 baud circuit is compatible with both 
Model 1 and III. The input signal is amplified and filtered 
by Op amps (U43 and U28. Part of U15 then forms a 
Zero Crossing Detector, the output of which sets the latch 
U40. A read of Port FF enables buffer U41, which allows 
the CPU to determine whether the latch has been set, and 
simultaneously resets the latch. The firmware determines 
by the timing between settings of the latch whether a logic 
"one" or "zero" was read in from the tape. 



The 1500 baud cassette read circuit is compatible with the 
Model III cassette system. The incoming signal is compared 
to a threshold by part of U15. U15's output will then be 
either high or low and clock about one-half of U39, depend- 
ing on whether it is a rising edge or a falling edge. If 
interrupts are enabled, the setting of either latch will gene- 
rate an interrupt. As in the 500 baud circuit, the firmware 
decodes the interrupts into the appropriate data. 

For any cassette read or write operation, the cassette relay 
must be closed in order to start the motor of the cassette 
deck. A write to port EC hex with bit one set will set latch 
U42, which turns on transistor Q4 and energizes the relay 
K1. A subsequent write to this port with bit one clear 
will clear the latch and de-energize the relay. 

3.1.11 Printer Circuitry 

The printer status lines are read by the CPU by enabling 
buffer U67. This buffer will be enabled for any input from 
port F8 or F9, or any memory read from location 37E8 
or 37E9 when in the Model III mode. For a listing of bit 
status, refer to the bit map. 

After the printer driver software determines that the printer 
is ready to receive another character (by reading the status), 
the character to be printed is output to port F8. This latches 
the character into U66, and simultaneouly fires the one-shot 
U65 to provide the appropriate strobe to the printer. 

3.1.12 I/O Connectors 

Two 20-pin single inline connectors, J7 and J8, are provided 
for the connection of a Floppy Disk Controller and an 
RS-232 Communications Interface, respectively. All eight 
data lines and the two least significant address lines are 
routed to these connectors. In addition, connections are 
provided for device or board selection, interrupt enable, 
interrupt status read, interrupt acknowledge, RESET, and 
the CPU WAIT signal. 

The graphics connector, J10, contains all of the above inter- 
face signals, plus CRTCLK, the dotclock signal, a graphics 
enable input, and other timing clocks which synchronize 
the graphics board with the CRTC. 

The I/O bus connector, J2, contains connections for all 
eight data lines (buffered by U74), the low order address 
lines (buffered by U73), and the control lines (buffered by 
U75) IN*, OUT*, RESET*, M1*, and IORQ*. In addition, 
the I/O bus connector has inputs to allow the device(s), 
connected to generate CPU WAIT states and interrupts. 



21 



The sound connector, J11, contains only four connections: 
sound enable (any output to port 90 hex), data bit DO, 
Vcc, and ground. 

3.1.13 Sound Option 

The Model 4 sound option, available as standard equipment 
on the disk drive versions, is a software intensive device. Data 



is sent out to port 90H, alternately setting and clearing 
data bit DO. The state of this bit is latched by sound board 
U1 and amplified by sound board Q1, which drives a pie- 
zoelectric sound transducer. The speed of the software 
loop determines the frequency, and thus, the pitch of the 
resulting tone. 
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3.2 MODEL 4 I/O BUS 

The Model 4 Bus is designed to allow easy and convenient 
interfacing of I/O devices to the Model 4. The I/O Bus 
supports all the signals necessary to implement a device com- 
patible with the Z-80s I/O structure. That is: 

Addresses: 

A0 to A7 allow selection of up to 256^ input and 256 
output devices if external I/O is enabled. 

1" Ports 80H to 0FFH are reserved for System use. 

Data: 

DB0 to DB7 allow transfer of 8-bit data onto the pro- 
cessor data bus if external I/O is enabled. 

Control Lines: 

a. IN* — Z-80 signal specifying that an input is in pro- 
gress. Gated with 10 RQ. 

b. OUT* — Z-80 signal specifying that an output is in 
progress. Gated with 10 RQ. 

c. RESET* - system reset signal. 

d. IOBUSINT* - input to the CPU signaling an inter- 
rupt from an I/O Bus device if I/O Bus interrupts 
are enabled. 

e. IOBUSWAIT* - input to the CPU wait line allow- 
ing I/O Bus device to force wait states on the Z-80 
if external I/O is enabled. 

f. EXTIOSEL* - input to CPU which switches the 
I/O Bus data bus transceiver and allows an INPUT 
instruction to read I/O Bus data. 

g. M1*-and IORQ* - standard Z-80 signals 

The address line, data line, and control lines a to c and e to g 
are enabled only when the ENEXIO bit in EC is set to a one. 

To enable I/O interrupts, the ENIOBUSINT bit in the CPU 
IOPORT E0 (output port) must be a one. However, even if 
it is disabled from generating interrupts, the status of the 
IOBUSINT* line can still read on the appropriate bit of CPU 
IOPORT E0 (input port). 

See Model 4 Port Bit assignment for port 0FF, EC, and 
0E0 on pages 28 and 29. 

The Model 4 CPU board is fully protected from "foreign 
I/O devices" in that all the I/O Bus signals are buffered and 
can be disabled under software control. To attach and use an 
I/O device on the I/O Bus, certain requirements (both hard- 
ware and software) must be met. 



For input port device use, you must enable external I/O de- 
vices by writing to port 0ECH with bit 4 on in the user soft- 
ware. This will enable the data bus address lines and cont- 
rol signals to the I/O Bus edge connector. When the input 
device is selected, the hardware will acknowlege by asserting 
EXTIOSEL* low. This switches the data bus transceiver and 
allows the CPU to read the contents of the I/O Bus data lines. 
See Figure 3.6 for the timing. EXTIOSEL* can be generated 
by NANDing IN and the I/O port address. 

Output port device use is the same as the input port device in 
use, in that the external I/O devices must be enabled by writ- 
ing to port 0ECH with bit 4 on in the user software - in the 
same fashion. 

For either input or output devices, the IOBUSWAIT* control 
line can be used in the normal way for synchronizing slow 
devices to the CPU. Note that since dynamic memories are 
used in the Model 4, the wait line should be used with cau- 
tion. Holding the CPU in a wait state for 2 msec or more may 
cause loss of memory contents since refresh is inhibited during 
this time. It is recommended that the IOBUSWAIT* line be 
held active no more than 500 /isec with a 25% duty cycle. 

The Model 4 will support Z-80 mode 1 interrupts. A RAM 
jump table is supported by the LEVEL II BASIC ROMs and 
the user must supply the address of his interrupt service 
routine by writing this address to locations 403E and 403F. 
When an interrupt occurs, the program will be vectored to 
the user supplied address if I/O Bus interrupts have been 
enabled. To enable I/O Bus interrupts, the user must set bit 
3 of Port0E0H. 
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Input or Output Cycles. 
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3.3 MODEL 4 PORT BITS 



Name: WRNMIMASKREG* 

Port Address: 0E4H 
Access: WRITE ONLY 

Bit 7 = ENINTRQ; disables Disk INTRQ from generating 
an NMI. 
1 enables above. 

Bit 6= ENDRQ; disables Disk DRQ from generating an 
NMI. 
1 enables above. 

Name: RDNMISTATUS* 

Port Address: 0E4H 
Access: READONLY 

Bit 7 = Status of Disk INTRQ; 1 = False, = True 

Bit 6 = Status of Disk DRQ; 1 = False, = True 

Bit 5 = Reset* Status; 1 = False, = True 



Name: MOD OUT 

Port Address: 0ECH 
Access: WRITE ONLY 

Bit 7 = Undefined 

Bit 6 = Undefined 

Bit 5 = DISWAIT; disables video waits, 1 enables 

Bit 4 = ENEXTIO; disables external IO Bus, 1 enables 

Bit 3 = ENALTSET; disables alternate character set, 
1 enables alternate video character set. 

Bit 2 = MODSEL; enables 64 character mode, 
1 enables 32 character mode. 

Bit 1 = CASMOTORON; turns cassette motor off, 
1 turns cassette motor on. 

Bit = Undefined 



Name: RDINTSTATUS* 

Port Address: 0E0H 
Access: READONLY 

NOTE: A indicates the device is interrupting. 

Bit 7 = Undefined 

Bit 6= RS-232 ERROR INT 

Bit 5= RS-232 RCV INT 

Bit 4= RS-232 XMIT INT 

Bit .3= IOBUSINT 

Bit 2= RTC INT 

Bit 1 = CASSETTE (1500 Baud) INT F 

Bit = CASSETTE (1500 Baud) INT R 

Name: CASOUT* 

Port Address: 0FFH 
Access: WRITE ONLY 

Bit 7 = Undefined 

Bit 6 = Undefined 

Bit 5 = Undefined 

Bit 4 = Undefined 

Bit 3 = Undfined 

Bit 2 = Undefined 

Bit 1 = Cassette output level 

Bit = Cassette output level 
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Name: WRINTMASKREG* 

Port Address: 0E0H 
Access: WRITE ONLY 

Bit 7 = Undefined 

Bit 6 = ENERRORINT; 1 enables RS-232 interrupts on par- 
ity error, framing error, or data overrun error. 
disable above. 

Bit 5 = ENRCVINT; 1 enables RS-232 receive data register 
full interrupts, 
©disables above. 

Bit 4 = ENXMITINT; 1 enables RS-232 transmitter holding 
register empty interrupts, 
disables above. 

Bit 3 = ENIOBUSINT; 1 enables I/O Bus interrupts, 
disables the above. 

Bit 2 = ENRTC; 1 enables real time clock interrupt, 
disables above. 

Bit 1 = ENCASINTF; 1 enables 1500 Baud falling edge inter- 
rupt, 
disables above. 

Bit = ENCASINTR; 1 enables 1500 Baud rising edge inter- 
rupt, 
disables above. 



Name: DRVSEL* 

Port Address: 0F4H 
Access: WRITE ONLY 

Bit 7 = FM7MFM; selects single density, 
1 selects double density. 

Bit 6 = WSGEN; = no wait states generated, 
1 = wait states generated. 

Bit 5 = PRECOMP; = no write precompensation, 
1 = write precompensation enabled. 

Bit 4 = SDSE L; selects side of diskette , 
1 selects side 1 of diskette. 

Bit 3 = Drive select 4 

Bit 2 = Drive select 3 

Bit 1 = Drive select 2 

Bit = Drive select 1 



Name: CAS IN* 

Port Address: 0FFH 
Access: READONLY 

Bit 7 = 500 Baud Cassette bit 

Bit 6 = Undefined 

Bit 5 = DISWAIT (See Port 0ECH definition) 

Bit 4 = ENEXTIO (See Port 0ECH definition) 

Bit 3 = ENALTSET (See Port 0ECH definition) 

Bit 2 = MODSEL (See Port 0ECH definition) 

Bit 1 = CASMOTORON (See Port 0ECH definition) 

Bit = 1500 Baud Cassette bit 

NOTE: Reading Port 0FFH clears the 1500 Baud Cassette 
interrupts. 
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Parts List, CPU PCB #6700104AA3 
Model 4 16K, Cassette Input 
Catalog number 26-1067 

Item Qty Description Mfgr's Part No. 

1 4 Cap, 100 pfd 50V C. Disk (Cl, 99,101, 8301104 

103) 

2 3 Cap, 10 ufd 35V Elec. Rad (C2-4) 8326103 

3 74 Cap, 0.1 ufd 50V Mono Axial 8374104 

(C5, 11-18, 23, 26-29, 31, 33-37, 39-41, 
43 47-55 57-97) 

4 1 Cap, 56'pfd 50V C. Disk NPO (C6) 8300563 

5 2 Cap, 47 pfd 50V C. Disk NPO (C7,9) 8300472 

6 2 Cap, 56 pfd 50V C. Disk (C8,24) 8300564 

7 1 Cap, 100 pfd 50V C. Disk (C10) 8301103 

8 1 Cap, .01 ufd 50V C. Disk (C19) 8303104 

9 1 Cap, 22 ufd 16V Elec. Rad(C20) 8326221 

10 4 Cap, .022 ufd 50V C. Disk (C21,32, 8303224 

44,108) 

11 1 Cap, 33 pfd 50V C. Disk (C22) 8300334 

12 1 Cap, .0047 ufd 50V C. Disk (C30) 8302474 

13 1 Cap, .0022 ufd 50V C. Disk (C42) 8302224 

14 2 Cap, .001 ufd 50V Mono Axial (C45,46) 8372104 

15 1 Cap, 200 pfd 50V (C56) 8301204 

16 1 Cap, 10 ufd 10V Tant. (C98) 8336101 

17 5 Cap, 150 pfd 50V C. Disk (C100,102 8301154 

104,107,109) 

18 1 Cap, 100 ufd 10V Tant. (C106) 8337101 

19 2 Connector, 4-Pin Right Angle (J4,Jll) 8519079 

20 1 Connector, 5-Pin Right Angle (J3) 8519091 

21 1 Connector, 6-Pin Right Angle (J5) 8519103 

22 1 Connector, Dual 10 Rt . Angle Header (J6) 8519107 

23 2 Connector, 20-Pin Flat Flex Cable (J7,8) 8519101 

24 1 Connector, 17-Pin Dual Header (J10) 8519169 

25 8 Diode, 1N4148 Zener 75V (CRl-7,10) 8150148 

26 1 Ferrite Bead (FBI) 8419014 

27 1 Inductor, 47uH (Ll) 8419028 

28 1 Inductor, .68uH (L2) 8419029 

29 1 IC, 74LS175 Quad Flip-Flop (U2) 8020175 

30 1 IC, PAL16R6A ( U3 ) 8075166 

31 1 IC, PAL16L8 (U4) 8075268 

32 1 IC, 74LS161 Binary Counter (U5) 8020161 
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Parts List, CPU PCB #6700104AA3 
Model 4 16K, Cassette Input 
Catalog number 26-1067 



Item 


Qty 


Description 


Mfgr's Part No. 


33 


8 


IC 


, 74LS244 Quad Tranceiver (U6,10, 
41,55,56,64,67,74) 


8020244 


34 


1 


IC, 


74LS37 3 Octal Latch (U7) 


8020373 


35 


2 


IC 


, 74LS273 Octal Flip-Flop (U8,37) 


8020273 


36 


1 


IC 


, 74LS153 Dual Multiplexer (U9) 


8020153 


37 


1 


IC 


, 74LS166 Shift Register (Ull) 


8020166 


38 


2 


IC 


, 74LS51 AND OR Invert (U12,20) 


8020051 


39 


2 


IC 


, 74LS00 Quad 2-IN NAND (Ul3,14) 


8020000 


40 


1 


IC 


, LM339 Comparator (U15) 


8050339 


41 


3 


IC 


, 74LS32 Quad 2-IN OR (Ul6,22,51) 


8020032 


42 


1 


IC 


, 74LS14 Hex Inverter (U17) 


8020014 


43 


3 


IC 


, 74LS174 Flip-Flop (Ul8,36,42) 


8020174 


44 


1 


IC 


, 74S04 (U19) 


8010004 


45 


1 


IC 


, 4016 200NS RAM 2K X 8 Static (U21) 


8040116 


46 


1 


IC 


, MCM68A316E Character Generator (U23) 8044316 


47 


1 


IC 


, 74LS86 Quad 2-IN OR (U24) 


8020086 


48 


1 


IC 


, 74LS04 Hex Inverter (U25) 


8020004 


49 


3 


IC, 


74LS08 Quad 2-IN AND (U26,46,52) 


8020008 


50 


5 


IC, 


74LS74 Dual Flip-Flop (U27,31,39 
40,53) 


8020074 


51 


1 


IC, 


MC1458 OP-AMP (U28) 


8050458 


52 


2 


IC 


, 7406 Hex Inverter (U29,30) 


8000006 


53 


1 


IC 


, 74LS10 Triple 3-IN NAND (U32) 


8020010 


54 


3 


IC 


, 74LS157 Quad Multiplexer (U33-35) 


8020157 


55 


2 


IC 


, 74LS367 Memory (U38,75) 


8020367 


56 


1 


IC 


, MC1741 OP-AMP (U43) 


8050741 


57 


2 


IC 


, MC14502 B CMOS Driver (U44,45) 


8030502 


58 


1 


IC 


, SY68045 CTC 60HZ (U47) 


8040045 


59 


3 


IC 


, 74LS138 Decoder (U48-50) 


8020138 


60 


2 


IC 


, 74LS240 Octal Buffer (U54,60) 


8020240 


61 


1 


IC 


, Z80A CPU (U57) 


8047880 


62 


1 


IC 


, PAL10L8 (U58) 


8075208 


63 


1 


IC 


, PAL16L8 (U59) 


8075368 


64 


1 


IC, 


7405 O.C. Buffer (U61) 


8000005 


65 


1 


IC 


74LS02 Quad 2-IN NOR (U62) 


8020002 


66 


2 


IC 


74157 Quad Multiplexer (U63,76) 


8000157 


67 


1 


IC, 


74LS123 Dual Multivibrator (U65) 


8020123 


68 


1 


IC 


, 74LS374 Octal Flip-Flop (U66) 


8020374 


69 


1 


IC, 


MCM68A364 ROM A (U68) 


8041364 


70 


1 


IC 


, MCM68A332 ROM B (U69) 


8040332 


71 


1 


IC 


, MCM68A316 ROM C (U70) 


8048316 


72 


2 


IC 


74LS245 Octal Tranceiver (U71,73) 


8020245 
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Parts List, CPU PCB #6700104AA3 
Model 4 16K, Cassette Input 
Catalog number 26-1067 



Item Qty Description 



73 
74 
75 

76 



1 
8 

1 



IC, DIP Shunt 4-POS 
IC, MCM4116 16K RAM 
IC, 74LS30 Positive 



, (U72) 
200NS (U77- 
NAND (U93) 



■84) 



77 


2 


Res, 


78 


1 


Res, 


79 


1 


Res, 


80 


2 


Res, 


81 


4 


Res, 


82 


1 


Res, 


83 


1 


Res, 


84 


13 


Res, 


85 


1 


Res, 


86 


1 


Res, 


87 


2 


Res, 


88 


2 


Res, 


89 


1 


Res, 


90 


1 


Res, 


91 


1 


Res, 


92 


3 


Res, 


93 


1 


Res, 


94 


7 


Res, 


95 


1 


Res , 


96 


2 


Res, 


97 


1 


Res, 


98 


1 


Res, 


99 


1 


Res, 


100 


1 


Res, 


101 


1 


Res, 


102 


1 


Res, 


103 


1 


Res, 


104 


4 


Res , 


105 


1 


Res, 


106 


1 


Res, 


107 


1 


Res 


108 


1 


Res 


109 


1 


Res 



Relay, 12V 2 AMP (Kl) 



510 ohm, 5% 1/4W (Rl,59) 

12K ohm, 5% 1/4W (R2) 

6.2K ohm, 1/4W (R3) 

470 ohm, 5% 1/4W (R4,23) 

10K ohm, 5% 1/4W (R5,9,14,16) 

3.6K ohm, 5% 1/4W (R6) 

91 ohm, 5% (R7) 

4.7K ohm, 5% 1/4W (R8,28,36, 
43-49,52,54,60) 

620K ohm, 5% 1/4W (R10) 

1.5M ohm, 5% 1/4W (Rll) 

56K ohm, 5% 1/4W (Rl2,17) 

15K ohm, 5% 1/4W (Rl3) 

51K ohm, 5% 1/4W (R15) 

6.8K ohm, 5% 1/4W (Rl8) 

8.2K ohm, 5% 1/4W (R19) 

220 ohm, 5% 1/4W (R20,27,37) 

680 ohm, 5% 1/4W (R2.1) 

100K ohm, 5% 1/4W (R22, 30-33, 
40,42) 

750 ohm, 5% 1/4W (R24) 

1.2K ohm, 5% 1/4W (R25,34) 

22 ohm, 5% 1/4W (R26) 

220K ohm, 5% 1/4W (R29) 

7.5K ohm, 5% 1/4W (R35) 

82K ohm, 5% 1/4W (R38) 

39K ohm, 5% 1/4W (R39) 

75K ohm, 5% 1/4W (R41) 

20K ohm, 5% 1/4W (R50) 

150 ohm, 5% 1/4W (R51 , 53 , 55 , 56 ) 

IK ohm, 5% 1/4W (R57) 

56 ohm, 5% 1/4W (R58) 
Pak, 820 ohm, SIP 10-PIN (RPl) 
Pak, 4.7K ohm, SIP 8-PIN (RP2) 
Pak, 27 ohm, DIP 16-PIN (RP4) 



Mfgr ' s Part No. 

8489057 
8042016 
8020030 

8429105 

8207151 
8207312 
8207262 
8207147 
8207310 
8207236 
8207091 
8207247 

8207462 
8207515 
8207356 
8207315 
8207351 
8207268 
8207282 
8207122 
8207168 
8207410 

8207175 
8207212 
8207022 
8207422 
8207275 
8207382 
8207339 
8207375 
8207320 
8207150 
8207210 
8207056 
8290182 
8292246 
8290027 
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Parts List, CPU PCB #6700104AA3 
Model 4 16K, Cassette Input 
Catalog number 26-1067 



Item Qty Description 



110 1 Transistor, 2N918 (Ql) 

111 2 Transistor, 2N3906 PNP (Q2,3) 

112 1 Transistor, 2N2222 (Q4) 



Mfgr's Part No. 



8110918 
8100906 
8110222 



MISCELLANEOUS 

Crystal, 20.2752 MHz (YD 8409031 

Crystal, 12.672 MHz (Y2) 8409030 

Jumper Wire 20 Gauge (Wl-3) *NOTE 

PCB Logic Board, Rev. PP3 8709296 

Regulator, 79L05, -5V (Q5) 8051905 
Socket, 20-Pin DIP (U3 , 4 , 58 , 59 , 71-73 ) 8509009 

Socket, 24-Pin DIP (U21, 23 ,68-70 ) 8509001 

Socket, 40-Pin DIP (U47,57) 8509002 

Socket, 16-Pin DIP (U77-84 ,85-92 ) 8509003 

Staking Pin (El-8, 11-15) 8529014 



Note: Wl,W3 are 4-1/2" long, W2 is 6" long 



113 


1 


114 


1 


115 


3 


116 


1 


117 


1 


118 


7 


119 


5 


120 


2 


121 


16 


122 


13 
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Parts List, CPU PCB 8858090 

Model 4 64K, Single or Double Drive 

Catalog Number 26-1068 or 26-1069 



Item 


Qty 


Description Mf gr * s Part No. 


1 


4 


Cap, 100 PFD 50V C. Disk (Cl, 99,101, 
103) 


8301104 


2 


3 


Cap, 10 MFD 35V ELEC . RAD (C2-4) 


8326103 


3 


58 


Cap, 0.1MFD 50V MONO AXIAL 

(C5, 11-18, 23, 26-29, 31,33-37,39-41, 

43,47-55,57-65,67,69,71,73,75,77,79 

81,83,85,87,89,91,93,95,97) 


8374104 


4 


1 


Cap, 56 PFD 50V C. DISK NPO (C6) 


8300563 


5 


2 


Cap, 47 PFD 50V C. DISK NPO (C7,9) 


8300472 


6 


2 


Cap, 56 PFD 50V C. DISK (C8,24) 


8300564 


7 


1 


Cap, 100 PFD 50V C. DISK (C10) 


8301103 


8 


1 


Cap, .01 MFD 50V C. DISK (C19) 


8303104 


9 


1 


Cap, 22 MFD 16 V ELEC. RAD(C20) 


8326221 


10 


4 


Cap, .022 MFD 50V C. DISK (C21,32, 
44,108) 


8303224 


11 


1 


Cap, 33 PFD 50V C. DISK (C22) 


8300334 


12 


1 


Cap, .0047 MFD 50V C. DISK (C30) 


8302474 


13 


1 


Cap, .0022 MFD 50V C. DISK (C42) 


8302224 


14 


2 


Cap, .001 MFD 5 0V MONO AXIAL (C45,46) 


8372104 


15 


1 


Cap, 200 PFD 50V (C56) 


8301204 


16 


1 


Cap, 10 MFD 10V TANT. (C98) 


8336101 


17 


5 


Cap, 150 PFD 50V C. DISK (Cl00,102 
104,107,109) 


8301154 


18 


1 


Cap, 100 MFD 10V TANT. (C106) 


8337101 


19 


2 


Connector, 4-Pin Right Angle (J4,Jll) 


8519079 


20 


1 


Connector, 5-Pin Right Angle (J3) 


8519091 


21 


1 


Connector, 6-Pin Right Angle (J5) 


8519103 


22 


1 


Connector, Dual 10 Rt. Angl. Header (J6) 


8519107 


23 


2 


Connector, 2 0-Pin Flat Flex Cable (J7,8) 


8519101 


24 


1 


Connector, 17-Pin Dual Header (J10) 


8519169 


25 


8 


Diode, 1N4148 Zener 75V (CRl-7,10) 


8150148 


26 


1 


Ferrite Bead (FBI) 


8419014 


27 


1 


Inductor, 4 7uH (Ll) 


8419028 


28 


1 


Inductor, .68uH (L2) 


8419029 


29 


1 


IC, 74LS175 Quad Flip-Flop (U2) 


8020175 


30 


1 


IC, PAL16R6A (U3) 


8075166 


31 


1 


IC, PAL16L8 (U4) 


8075268 
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Parts List, CPU PCB 8858090 

Model 4 64K, Single or Double Drive 

Catalog number 26-1068 or 26-1069 



Item Qty Description Mfgr's Part No, 

74LS161 Binary Counter (U5) 8020161 

74LS244 Quad Tranceiver (U6,10, 8020244 
41,55,56,64,67,74) 

74LS373 Octal Latch (U7) 8020373 

74LS273 Octal Flip-Flop (U8,37) 8020273 

74LS153 Dual Multiplexer (U9) 8020153 

74LS166 Shift Register (Ull) 8020166 

74LS51 AND OR Invert (U12,20) 8020051 

74LS00 Quad 2-In NAND (Ul3,14) 8020000 

LM339 Comparator (U15) 8050339 

74LS32 Quad 2-In OR (U16,22,51) 8020032 

74LS14 Hex Inverter (U17) 8020014 

74LS174 Flip-Flop (Ul8,36,42) 8020174 

74S04 (U19) 8010004 
40.16 200NS RAM 2K X 8 Static (U21) 8040116 
MCM68A316E Character Generator (U23) 8044316 

74LS86 Quad 2-In OR (U24) 8020086 

74LS Hex Inverter (U25) 8020004 

74LS08 Quad 2-In AND (026,46,52) 8020008 

74LS74 Dual Flip-Flop (U27,31,39 8020074 
40,53) 

MC1458 OP-AMP (U28) 8050458 

7406 Hex Inverter (U29,30) 8000006 

74LS10 Triple 3-In NAND (U32) 8020010 

74LS157 Quad Multiplexer (U33-35) 8020157 

74LS367 Memory (U38,75) 8020367 

MC1741 OP-AMP (043) 8050741 

MC14502 B CMOS Driver (U44,45) 8030502 

SY68045 CTC 50Hz Version (047) 8041045 

74LS138 Decoder (U48-50) 8020138 

74LS240 Octal Buffer (054,60) 8020240 

Z80A CPU (057) 8047880 

PAL10L8 (058) 8075208 

PAL16L8 (059) 8075368 

7405 O.C. Buffer (061) 8000005 

74LS02 Quad 2-In NOR (062) 8020002 

74157 Quad Multiplexer (U63,76) 8000157 

74LS123 Dual Multivibrator (065) 8020123 

74LS374 Octal Flip-Flop (U66) 8020374 

MCM68A364 ROM A (U68) 8048364 

MCM68A332 ROM B (069) 8040332 

MCM68A316 ROM C (070) 8042316 



32 


1 


IC, 


33 


8 


IC, 


34 


1 


IC, 


35 


2 


IC, 


36 


1 


IC, 


37 


1 


IC, 


38 


2 


IC, 


39 


2 


IC, 


40 


1 


IC, 


41 


3 


IC, 


42 


1 


IC, 


43 


3 


IC, 


44 


1 


IC, 


45 


1 


IC, 


46 


1 


IC, 


47 


1 


IC, 


48 


1 


IC, 


49 


3 


IC, 


50 


5 


IL g 


51 


1 


IC, 


52 


2 


IC, 


53 


1 


IC, 


54 


3 


IC, 


55 


2 


IC, 


56 


1 


IC, 


57 


2 


IC, 


58 


1 


IC, 


59 


3 


IC, 


60 


2 


IC, 


61 


1 


IC, 


62 


1 


IC, 


63 


1 


IC, 


64 


1 


IC, 


65 


1 


IC, 


66 


2 


IC, 


67 


1 


IC, 


68 


1 


IC, 


69 


1 


IC, 


70 


1 


IC, 


71 


1 


IC, 
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Parts List CPU PCB 8858090 

Model 4 64K, Single or Double Drive 

Catalog number 26-1068 and 26-1069 



Item 


Qty 


Description 




Mfgr ' s Part No. 


72 


2 


ic, 


74LS245 Octal Tranceiver (U71,73) 


8020245 


73 


1 


IC, 


DIP Shunt 4-Pos. (U72) 




8489057 


74 


8 


IC, 


MCM6665 64K RAM 200NS (U85 


-92) 


8040665 


75 


1 


IC, 


74LS30 Positive NAND (U93) 




8020030 


76 


1 


Relay, 12V 2 Amp (Kl) 




8429105 


77 


2 


Res, 


5.10 ohm, 5% 1/4W (Rl,59) 




8207151 


78 


1 


Res , 


12K ohm, 5% 1/4W (R2) 




8207312 


79 


1 


Res, 


6.2K ohm, 1/4W (R3) 




8207262 


80 


2 


Res 


, 470 ohm, 5% 1/4W (R4,23) 




8207147 


81 


4 


Res 


10K ohm, 5% 1/4W (R5,9,14 


,16) 


8207310 


82 


1 


Res 


3.6K ohm, 5% 1/4W (R6) 




8207236 


83 


1 


Res 


91 ohm, 5% (R7) 




8207091 


84 


13 


Res 


, 4.7K ohm, 5% 1/4W (R8,28, 
43-49,52,54,60) 


36, 


8207247 


85 


1 


Res 


, 620K ohm, 5% 1/4W (R10) 




8207462 


86 


1 


Res 


, 1.5Meg ohm, 5% 1/4W (Rll) 




8207515 


87 


2 


Res 


56K ohm, 5% 1/4W (Rl2,17) 




8207356 


88 


2 


Res, 


15K ohm, 5% 1/4W (Rl3) 




8207315 


89 


1 


Res 


, 51K ohm, 5% 1/4W (R15) 




8207351 


90 


1 


Res 


, 6.8K ohm, 5% 1/4W (R18) 




8207268 


91 


1 


Res 


, 8.2K ohm, 5% 1/4W (R19) 




8207282 


92 


3 


Res 


, 220 ohm, 5% 1/4W (R20,27, 


37) 


8207122 


93 


1 


Res 


, 680 ohm, 5% 1/4W (R21) 




8207168 


94 


7 


Res 


, 100K ohm, 5% 1/4W (R22,30 
40,42) 


-33, 


8207410 


95 


1 


Res 


r 750 ohm, 5% 1/4W (R24) 




8207175 


96 


2 


Res 


, 1.2K ohm, 5% 1/4W (R25,34) 


8207212 


97 


1 


Res 


, 22 ohm, 5% 1/4W (R26) 




8207022 


98 


1 


Res 


, 220K ohm, 5% 1/4W (R29) 




8207422 


99 


1 


Res 


, 7.5K ohm, 5% 1/4W (R35) 




8207275 


100 


1 


Res 


, 82K ohm, 5% 1/4W (R38) 




8207382 


101 


1 


Res 


, 39K ohm, 5% 1/4W (R39) 




8207339 


102 


1 


Res 


, 75K ohm, 5% 1/4W (R41) 




8207375 


103 


1 


Res 


, 20K ohm, 5% 1/4W (R50) 




8207320 


104 


4 


Res 


, 150 ohm, 5% 1/4W (R51,53, 


55,56) 


8207150 


105 


1 


Res 


, IK ohm, 5% 1/4W (R57) 




8207210 


106 


1 


Res 


, 56 ohm, 5% 1/4W (R58) 




8207056 


107 


1 


Res 


Pak, 820 ohm, SIP 10-Pin (RPl) 


8290182 


108 


1 


Res 


Pak, 4.7K ohm, SIP 8-Pin (RP2) 


8292246 


109 


1 


Res 


Pak, 27 ohm, DIP 16-Pin (RP4) 


8290027 
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110 


1 


Transistor, 


111 


2 


Transistor, 


112 


1 


Transistor, 



Parts List CPU PCB 8858090 

Model 4 64K, Single or Double Drive 

Catalog number 26-1068 and 26-1069 

Item Qty Description Mfgr's Part No, 

2N918 (Ql) 8110918 

2N3906 PNP (Q2,3) 8100906 

2N2222 (Q4) 8110222 



MISCELLANEOUS 

113 1 Crystal, 20.2752 MHz (Yl) 8409031 

114 1 Crystal, 12.672 MHz (Y2) 8409030 

115 3 Jumper Wire, 20 Gauge (Wl-3) *NOTE 

116 1 PCB, Logic Board Rev. PP3 8709296 

117 7 Socket, 20-Pin DIP ( U3 , 4 , 58 , 59 , 71-73 ) 8509009 

118 5 Socket, 24-Pin DIP (U21 , 23 , 68-70 ) 8509001 

119 2 Socket, 40-Pin DIP (U47,57) 8509002 

120 16 Socket, 16-Pin DIP ( U77-84 ,85 ,-92 ) 8509003 

121 10 Staking Pin (El-8, 11-15) 8529014 



56 



SECTION IV 



FLOPPY DISK INTERFACE 
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4.1 MODEL 4 FDC PCB #8858060 



The TRS-80 Model 4 Floppy Disk interface Board is an 
optional board which if incorporated provides a standard five 
inch floppy disk controller. The Floppy Disk Interface Board 
supports both single and double density encoding schemes. 
This feature, along with a special software package, allows 
the transfer of Model I disk files to the Model 4 system. 
Write precompensation can be software enabled or disabled 
beginning at any track, although the system software enables 
write precompensation for all tracks greater than twenty -one. 
The amount of write precompensation is continuously 
variable from nsec to more than 500 nsec. The write pre- 
compensation is factory adjusted to 200 nsec. The data 
clock recovery logic incorporates a phaselocked loop oscil- 
lator Which achieves state-of-the-art reliability. One to four 
drives may be controlled by the interface (two internal 
drives and two external). All data transfers are accomplished 
by CPU data requests. In double density operation, data 
transfers are synchronized to the CPU by forcing a wait 
to the CPU and clearing the wait by a data request from the 
FDC chip. The end of the data transfer is indicated by 
generating a non-maskable interrupt from the interrupt 
request output of the FDC chip. A hardware watchdog 
timer insures that error conditions will not hang the wait 
line to the CPU for a period long enough to destroy RAM 
contents. 

4.1.1 Control and Data Buffering 

Refer to the Schematic Diagram 8000095. 

The Floppy Disk Controller Board is an 1/0 port mapped 
device which utilizes ports E4H, F0H, F1H, F2H, F3H, and 
F4H. The decoding logic is implemented on the CPU board. 
(See the Decoding Logic section of the CPU discussion.) U4 
of the Floppy Disk Controller Board is a non-inverting octal 
buffer which isolates and buffers the required control signals. 
Table 4-1 and Table 4-2 summarize the port and bit alloca- 
tion for the Floppy Controller Board. U2 of the Floppy Disk 
Controller Board is a bi-directional, 8-bit transceiver used to 
buffer data to and from the Floppy Controller Board. The 
direction of data transfer is controlled by the combination 
of control signals DISKIN* and RDNMIMASKREG*. If 
either signal is active (logic low), U2 is enabled to drive data 
onto the CPU board data bus. If both signals are inactive 
(logic high), U2 is enabled to receive data from the CPU data 
bus. 

4.1.2 Nonmaskable Interrupt Logic 

A dual "D" flip-flop (U5) is used to latch data bits D6 and 
D7 on the rising edge of the control signal WRNMIMAS- 
REG*. The outputs of U5 control the conditions which will 
generate a non-maskable interrupt to the CPU. The NMI 
interrupt conditions are programmed by doing an OUT in- 
struction to port E4H with the appropriate bits set. If data 



bit 7 is set, an NMI will be generated by an FDC interrupt 
request. If data bit 7 is reset, interrupt requests from the 
FDC are disabled. If data bit 6 is set, an NMI will be gener- 
ated by Motor Time Out. If data bit 6 is reset, interrupts on 
Motor Time Out are disabled. An IN instruction from port 
E4H enables the CPU to question the Floppy Disk Con- 
troller Board to determine the source of the non-maskable 
interrupt. Data bit 7 indicates the status of FDC interrupt 
request (0=true, 1 = false). Data bit 6 indicates the status of 
Motor Time Out (0 = true, 1 = false). Data bit 5 indicates the 
status of the front panel reset (0 = true, 1 = false). The con- 
trol signal RDNMIMASKREG* when active (logic 0), gates 
this status onto the CPU data bus. 



4.1.3 Drive Select Latch and Motor On Logic 

Selecting a drive prior to a disk I/O operation is accom- 
plished by doing an OUT instruction to port F4H with the 
proper bit set. The following table describes the bit alloca- 
tion of the Drive Select Latch. 



DATA BIT 


FUNCTION 


DO 


Selects Drive when set * 


D1 


Selects Drive 1 when set * 


D2 


Selects Drive 2 when set * 


D3 


Selects Drive 3 when set * 


D4 


Side selected when reset, 




Side 1 selected if set 


D5 


Write Precom. engaged when set 




disabled if reset 


D6 


Generate waits if set, 




no waits if reset 


D7 


Selects MFM mode if set, 




FM mode if reset 


*Only one 


of these bits should be set per output. 



Table 4.1. Port F4H Bit Allocation 

A hex "D" flip-flop (U6) latches the drive select bits, side 
select and FM*/MFM bits on the rising edge of the control 
signal IDRVSEL*. A dual "D" flip-flop (U18) is used to 
latch the Wait Enable and Precompensation enable bits on 
the rising edge of IDRVSEL*. The rising edge of IDRVSEL* 
also triggers a one-shot (1/2 of U 15) which produces a Motor 
On to the disk drives. The duration of the Motor On signal 
is approximately two seconds. The spindle motors are not 
designed for continuous operation, therefore the inactive 
state of the Motor On signal is used to clear the Drive Select 
Latch, which de-selects any drives which were previously 
selected. The Motor On one-shot is retriggerable by simply 
executing an OUT instruction to the Drive Select Latch. 
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4.1.4 Wait State Generation and WAITIMOUT Logic 

As previously mentioned, a wait state to the CPU can be 
initiated by an output to the Drive Select Latch with D6 set. 
Pin 5 of U18 will go high after this operation. This signal is 
inverted by 1/6 of U1 and is routed to the CPU board where 
it forces the Z-80 into a wait state. The Z-80 will remain in 
the wait state as long as WAIT* is low. Once initiated, the 
wait state will remain until one of four conditions are satis- 
fied. One half of U10 (a five input NOR gate) is used to per- 
form this function. INTRO, D RQ, RESET, and WAITIMOUT 
are the inputs to the NO R gate. If any one of these inputs are 
active (logic high), the output of the NOR gate (U10 pin 6) 
will go low. This output is tied to the clear input of the wait 
latch. This signal, when low, will clear the Q output (U18 
pin 5) and set the Q* output (U18 pin 6). This condition 
causes WAIT* to go high and allows the Z-80 to exit the wait 
state. U20 is a 12-bit binary counter which serves as a watch- 
dog timer to insure that a wait condition will not persist 
long enough to destroy dynamic RAM contents. The counter 
is clocked by a 1 MHz signal and is enabled to count when its 
reset pin is low (U20 pin 11). A logic high on U20 pin 11 
resets the counter ouputs. U20 pin 15 is the divide by 1024 
output and is used to generate the signal WAITIMOUT. 
This watchdog timer logic will limit the duration of a wait to 
1024/jsec, even if the FDC chip fails to generate a data 
request or an interrupt request. 



will go low indicating that an external drive is selected. 
One half of U10 (a five input NOR gate) is used to detect 
when one of the four drives is selected. The output of this 
NOR gate (U10 pin 5) is inverted and is used as the head load 
timing and ready signal for the 1793 FDC chip. Therefore if 
any drive is selected, the head is assumed to be loaded and 
the selected drive is assumed to be ready. 

4.1.7 Read/Write Data Pulse Shaping Logic 

Two one-shots (1/2 of U15 and 1/2 of U23) are used to 
insure that the read and write data pulses are approximately 
450nsec in duration. 

4.1.8 Disk Bus Output Drivers 

High current open collector drivers (U21 , U9, and U1) are 
used to buffer the output signals from the Drive Select 
Latch and the FDC chip to the floppy disk drives. Note from 
the schematic that each output signal to the drives has 
two buffers associated with each signal, one set is used for 
the internal drive bus and the other set is used for the ex- 
ternal bus. No select logic is required for these output sig- 
nals since the drive select bits define which drive is active. 

4.1.9 Write Precompensation and Clock Recovery Logic 



4.1.5 Clock Generation Logic 

A 4MHz crystal oscillator and a divide by 2 and divide by 4 
counter generate the clock signals required by the FDC 
board. The basic 4MHz oscillator is implemented with two 
invertors (1/3 of U25) and a quartz crystal (Y1 ). One half of 
U24 is used to divide the basic 4MHz clock by 2 to produce 
a 2MHz output at U24 pin 6. This output is again divided by 
2 using the remaining half of U24 to produce a 1 MHz output 
at U24 pin 8. The 1MHz clock is used to drive the clock 
input of the 1793 FDC chip and the clock input of the 
watchdog time (U20). 

4.1.6 Disk Bus Selector Logic 

As mentioned previously, the Model 4 Floppy Disk Board 
supports up to four drives (two internal, two external). This 
function is implemented by using two disk drive interface 
buses, one for the internal drives and one for the external 
drives. J4 is the edge connector used for the internal drives 
and J1 is the edge connector for the external drives. U22 
(a quad 2 to 1 data selector) is used to select which set 
of inputs from the disk drive buses are routed to the 1793 
FDC chip. U22 pin 1 is the control pin for the data selector. 
If U22 pin 1 is low, the external inputs are selected, other- 
wise the internal inputs are selected. This control signal 
(labeled EXTSEL*) is derived from the outputs of the Drive 
Select Latch. If Drive 2 or Drive 3 is selected, U17 pin 1 



The Write Precompensation and Read Clock Recovery logic 
is comprised of U11 (WD1691), U13 (WD2143) and U14 
(LS629), along with a few passive components. The WD1691 
is an LSI device which minimizes the external logic required 
to interface the 1793 FDC chip to a disk drive. With the use 
of an external VCO, U14,the WD1691 will derive the RCLK 
signal for the 1793, while providing an adjustment signal for 
the VCO, to keep the RCLK synchronous with the read data 
from the drive. Write precompensation control signals are 
also provided by the WD 1691 to interface directly to the 
WD2143 (U13) clock generator. The Read Clock Recovery 
section of the WD1691 has five inputs: DDEN*, VCO, 
RDD*, WG, and VFOE*/WF. It also has three outputs: 
PU, PD*, and RCLK. The inputs VFOE*/WF and WG when 
both are low, enable the Clock Recovery logic. When WG is 
high, a write operation is in progress and the Clock Recovery 
circuits are disabled regardless of the state of any other 
inputs. 

The Write Precompensation section of the WD1691 was 
designed to be used with the WD2143 clock generator. 
Write Precompensation is not used in single density mode 
and the signal DDEN* when high indicates this condition. 
In double density mode (DDEN* = 0), the signals EARLY 
and LATE are used to select a phase input (01 - 04) on the 
leading edge of WDIN. The STB line is latched high when 
this occurs, causing the WD2143 to start its pulse generation. 
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02 is used as the write data pulse on nominal (EARLY = 
LATE = 0), 01 is used for the early, and 03 is used for the 
late. The leading edge of 04 resets the STB line in anticipa- 
tion of the next write data pulse. When TG43 = or DDEN* 
= 1, precompensation is disabled and any transitions on the 
WDIN line will appear on the WDOUT line. 

When VFOE*/WF and WG are low, the Clock Recovery cir- 
cuits are enabled. When the RDD* line goes low, the PU or 
PD* signals will become active. If the RDD* has made its 
transition in the beginning of the RCLK window, PU will 
go from a high impedence state to a logic one, requesting an 
increase in VCO frequency. If the RDD* line has made it 
transition at the end of the RCLK window, PU will remain 
in the high impedence state while PD* will go to a logic zero, 
requesting a decrease in the VCO frequency. When the lead- 
ing edge of RDD* occurs in the center of the RCLK window, 
both PU and PD* will remain in the high impedence state, 
indicating that no adjustment of the VCO frequency is re- 
quired. By tying PU and PD* together, an adjustment signal 
is created which will be forced low for a decrease in VCO 
frequency and forced high for an increase in VCO freq- 
uency. To speed up rise times and stabilize the output volt- 
age, a resistor divider using R7, R10,and R9 is used to adjust 
the tri-state level at approximately 1.4V. This adjustment 
results in a worst case voltage swing of plus or minus 1V, 
which is acceptable for the frequency control input of the 
VCO (U14). This signal derived from the combination of PU 
and PD* will eventually correct the VCO input to exactly 
the same frequency multiple as the FDD* signal. The leading 
edge of the RDD* signal will then occur in the exact center 
of the RCLK window, an ideal condition for the 1793 inter- 
nal recovery circuits. 



4.1.11 Adjustments and Jumper Options 

The Data Separator must be adjusted with the 1793 in an 
idle condition (no command currently in operation). Adjust 
R7 potentiometer for a 1.4V level on pin 2 of U14. Then 
adjust R6 potentiometer to yield a 2MHz square wave at 
pin 16 of U11. 

The Write Precompensation must be adjusted while executing 
a continuous write command on a track greater than twenty- 
one. Adjust R5 potentiometer to yield 200nsec wide pulses 
at pin 4 of U11. This results in a write precompensation 
value of 200nsec. 

There are four jumper options on the Floppy Disk Controller 
Board. They are designated on the PC Board silkscreen and 
are referenced on the Schematic Diagram. The jumpers 
should be installed as described below. 

JUMPER CONNECTIONS 

A to B 
Eto G 
Lto M 
Hto J 



4.1.10 Floppy Disk Controller Chip 

The 1793 is an MOS LSI device which performs the func- 
tions of a floppy disk formatter/controller in a single chip 
implementation. The 1793 is functionally identical to the 
1791 used on the Model II FDC Printer Interface Board, 
except that the data bus is true as opposed to inverted. Refer 
to the appendix section for more information on the 
FD1793. The Model II Technical Reference Manual also 
contains a good presentation of the 1791 FDC chip as well as 
a discussion on Write Precompensation. The following port 
addresses are assigned to the internal registers of the 1793 
FDC chip. 



PORT# 



FUNCTION 



F0H 
F1H 
F2H 
F3H 



Command/Status Register 
Track Register 
Sector Register 
Data Register 



Table 4.2 Port Allocation 
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TPI<* 



RESET 
WAITIMOU 
INTRQ 



DISKIN * 
DtSKOOT*}- 

Al \ 
wRNKXM«lCRRi*i^ 
DRVSTL *}■ 



2, *, « , /#, 3* 

are ic are or 
J I , J» 
fill odd pii" 

Gjrouf'dejl Or) 
Jl, J* 




<F- RD * 



no n. 



NOTES: 

1. All capacitor values are in micro-farads and 
all resistor values are in ohms unless other- 
wise stated. 

2. On some boards, R5 may appear as a 1 K 
resistor and R21 may appear as a 750 ohm 
resistor. 



SCHEMATIC 8000095E, FLOPPY DISK CONTROLLER #8858060 
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COMPONENT LOCATION/CIRCUIT TRACE 
FLOPPY DISK INTERFACE PC BOARD - COMPONENT SIDE 
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CIRCUIT TRACE, FLOPPY DISK INTERFACE PC BOARD - SOLDER SIDE 
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SYMBOL 



PARTS LIST, FLOPPY DISK INTERFACE PC BOARD 
#8858060 

MANUFACTURER'S 
DESCRIPTION PART NUMBER 



RADIO SHACK 
PART NUMBER 



INTEGRATED CIRCUITS (cont'd) 



U6 
U7 
U8 
U9 
U10 
U11 
U12 
U13 
U14 
U15 
U16 
U17 
U18 
U19 
U20 
U21 
U22 
U23 
U24 
U25 



74LS174,Quad "D" Flip-Flop 

WD1793 

74LS38.NAND Buffer 

7416, Hex Inverter/Buffer 

74LS260,Dual NOR gate 

WD1691 

MC140733, AND gate 

WD2143-01 

74LS629. VCO 

74LS123, Mono Multivibrator 

74LS367,Hex Buffer 

74LS02,NANDgate 

74LS74,Dual "D" Flip-Flop 

74LS368, Hex Inverter/Buffer 

MC14040B, Binary Counter 

7416, Hex Inverter/Buffer 

74LS157,Quad Multiplexer 

74LS123, Mono Multiplexer 

74LS74,Dual "D" Flip-Flop 

74LS04, Hex Inverter 



802-0174 
850-9002 
802-0038 
800-0016 
802-0260 
850-9009 
803-0073 
850-9006 
802-0629 
802-0123 
802-0367 
802-0002 
802-0074 
802-0368 
803-0040 
800-0016 
802-0157 
802-0123 
802-0074 
802-0004 



AMX3565 
AXX3041 
AMX4328 



AMX4471 

AMX4472 
AMX4663 
AMX3803 
AMX3567 
AMX3551 
AMX3558 
AMX3568 
AMX4666 

AMX3563 
AMX3803 
AMX3558 
AMX3552 



RESISTORS 



R1 
R2 
R3 
R4 
R5 
R6 
R7 
R8 
R9 
R10 
R11 
R12 
R13 
R14 
R15 
R16 
R17 
R18 
R19 
R20 



2.2K, 1/4W,5% 

150ohm,1/4W,5% 

150 ohm, 6 pin resistor network 

2.2K, 1/4W,5% 

1 K, Trim Pot 

50K, Trim Pot 

100K,Trim Pot 

10K,1/4W, 5% 

47 K, 1/4W, 5% 

47K, 1/4W,5% 

10K, 1/4W, 5% 

10K,1/4W,5% 

47 ohm, 1/4W,5% 

270K, 1/4W,5% 

150 ohm, 10 pin resistor network 

10K, 1/4W,5% 

910 ohm, 1/4W, 5% 

91Qohm,1/4W, 5% 

2.2 K, 1/4W, 5% 

22K,1/4W, 5% 



820-7222 
820-7115 
829-0012 
820-7222 
827-9210 
827-9350 
827-9410 
820-7310 
820-7347 
820-7347 
820-7310 
820-7310 
820-7047 
820-7427 
829-0013 
820-7310 
820-7191 
820-7191 
820-7222 
820-7322 



AN0216EEC 
AN0142EEC 

ARX0241 

AN0216EEC 

AP0835 

AP7168 

AN0281EEC 
AN0340EEC 
AN0340EEC 
AN0281EEC 
AN0281EEC 
AN0099EEC 

ARX0242 
AN0281EEC 
AN0192EEC 
AN0192EEC 
AN0216EEC 



Socket, 18 pin 
Socket, 20 pin 
Socket, 40 pin 



1ISCELLANEOUS 



850-9006 
850-9009 
850-9002 



AJ6701 
AJ6760 
AJ6580 



FDC Board, complete assembly 
FDC Board, without major chips 



AXX0510 
AXX0509 
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PARTS LIST, FLOPPY DISK INTERFACE PC BOARD 
#8858060 



SYMBOL 



DESCRIPTION 



MANUFACTURER'S 
PART NUMBER 



RADIO SHACK 
PART NUMBER 



CAPACITORS 



C1 
C2 
C3 
C4 
C5 
C6 
C7 
C8 
C9 
C10 
C11 
C12 
C13 
C14 
C15 
C16 
C17 
C18 
C19 
C20 



O.IjuF, 50V, monolithic, radial 
0.1/uF, 50V, monolithic, radial 
0.1;uF, 50V, monolithic, radial 
O.ljuF, 50V, monolithic, radial 
O.ljuF, 50V, monolithic, radial 
0.1juF,50V, monolithic, radial 
75pF, 50V, ceramic disc 
33/^F, 16V, electrolytic, radial 
100pF, 50V, ceramic disc 
0.1/iF, 50V, monolithic, radial 
0.47/iF, 16V, mylar 
0.1/jF, 50V, monolithic, radial 
0.1/iF, 50V, monolithic, radial 
100pF, 50V, ceramic disc 
O.I^F, 50V, monolithic, radial 
470pF, 50V, ceramic disc 
10a<F, 16V, electrolytic, radial 
10jUF, 16V, electrolytic, radial 
0.01/iF, 16V, ceramic disc 
0.022a<F, 50V, ceramic disc 



8384104 
838-4104 
8384104 
8384104 
8384104 
8384104 
830-0754 
839-6331 
830-1104 
8384104 
8354471 
8384104 
8384104 
830-1104 
8384104 
830-1474 
832-6101 
832-6101 
830-3104 
830-3224 



ACC104QJAP 
ACC104QJAP 
ACC104QJAP 
ACC104QJAP 
ACC104QJAP 
ACC104QJAP 

ACC336QDAP 

ACC101QJCP 
ACC104QJAP 

ACC104QJAP 
ACC104QJAP 
ACC101QJCP 
ACC104QJAP 
ACC471QJCP 
ACC106QDAP 
ACC106QDAP 
ACC103QJCP 
ACC223QJCP 



C23 
C24 
C25 
C26 
C27 
C28 
C29 
C30 



0.022//F, 50V, ceramic disc 
180pF, ceramic disc 
180pF, ceramic disc 
180pF, ceramic disc 
0.022/iF, ceramic disc 
180pF, ceramic disc 
0.022/^F, ceramic disc 
100pF, ceramic disc 



830-3224 
830-1184 
830-1184 
830-1184 
830-3224 
830-1184 
830-3224 
830-1104 



ACC223QJCP 



ACC223QJCP 

ACC223QJCP 
ACC101QJCP 



CONNECTORS 



J2 
J3 



20 pos. right angle 

4 pin right angle header 



851-9078 
851-9079 



AJ6977 



CRYSTAL 



Y1 



4 MHz 



840-9010 



AMX2804 



DIODES 



CR1 



MZ4682 



815-0682 



ADX1518 



INTEGRATED CIRCUITS 



U1 
U2 
U3 
U4 
U5 



7416, Hex Inverter/Buffer 
74LS245 

74LS00,N AND gate 
74LS244, Octal Buffer 
74LS74,Dual "D" Flip-Flop 



800-0016 
802-0245 
802-0000 
802-0244 
802-0074 



AMX4470 
AMX3550 
AMX3864 
AMX3558 
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4.2 MODEL 4 FDC PCB #8858160 



The TRS-80 Model Ml/4 Floppy Disk Interface Board is an 
optional board which, if incorporated, provides a standard 
5-1/4" floppy disk controller. The Floppy Disk Interface 
Board supports both single and double density encoding 
schemes. Write precompensation can be software enabled or 
disabled beginning at any track, although the system soft- 
ware enables write precompensation for all tracks greater 
than twenty-one. The amount of write precompensation 
provided is 250 nsec and is not adjustable. The data clock 
recovery logic incoporates a digital data separator which 
achieves state-of-the-art reliability. One to four drives may be 
controlled by the interface (two internal drives and two 
external). All data transfers are accomplished by CPU data 
requests. In double density operation, data transfers are 
synchronized to the CPU by forcing a wait to the CPU 
and clearing the wait by a data request from the FDC chip. 
The end of the data transfer is indicated by generation of a 
non-maskable interrupt from the interrupt request output 
of the FDC chip. A hardware watchdog timer insures that 
any error condition will not hang the wait line to the CPU 
for a period long enough to destroy RAM contents. 

4.2.1 Control and Data Buffering 

Refer to Schematic Diagram 8000168 

The Floppy Disk Controller Board is an I/O port mapped 
device which utilizes ports E4H, F0H, F1H, F2H, F3H, and 
F4H. The decoding logic is implemented on the CPU board. 
(Refer to Paragraph 3.1.4 Decoding Logic of the CPU 
operation). U4 is a non-inverting octal buffer which isolates 
and buffers the required control signals from the CPU 
board to the FDC board. U2 is a bi-directional, 8-bit trans- 
ceiver used to buffer data to and from the FDC board. The 
direction of data transfer is controlled by the combination 
of control signals DISKIN* and RDNMISTATUS*. If either 
signal is active (logic low), U2 is enabled to drive data onto 
the CPU board data bus. If both signals are inactive (logic 
high), U2 is enabled to receive data from the CPU board data 
bus. 

4.2.2 Nonmaskable Interrupt Logic 

A dual D flip-flop (U12) is used to latch data bits D6 and D7 
on the rising edge of the control signal WRNMIMASKREG*. 
The outputs of U12 enable the conditions which will gene- 
rate a non-maskable interrupt to the CPU. The NMI interrupt 
conditions are programmed by doing an OUT instruction 
to port E4H with the appropriate bits set. If data bit 7 is 
set, an FDC interrupt request is enabled to generate an 
NMI interrupt. If data bit 7 is reset, interrupt requests from 
the FDC are disabled. If data bit 6 is set, a Motor Time Out 
is enabled to generate a NMI interrupt. If data bit 6 is reset, 
interrupts on Motor Time Out are disabled. An IN instruc- 
tion from port E4H enables the CPU to check the FDC 



board to determine the source of the non-maskable interrupt. 
Data bit 7 indicates the status of FDC interrupt request 
(0 = true, 1 = false). Data bit 6 indicates the status of Motor 
Time Out (0 = true, 1 = false). Data bit 5 indicates the status 
of the Reset signal from the CPU board (0 = true, 1 = false). 
The control signal RDNMISTATUS* gates this status onto 
the CPU data bus when active (logic low). 

4.2.3 Drive Select Latch and Motor ON Logic 

Selecting a drive prior to a disk I/O operation is accomplish- 
ed by doing an OUT instruction to port F4H with the 
proper bit set. The following table described the bit alloca- 
tion of the Drive Select Latch: 



Data Bit 

DO 
D1 
D2 
D3 
D4 

D5 

D6 
D7 



Function 

Selects Drive when set* 
Selects Drive 1 when set* 
Selects Drive 2 when set* 
Selects Drive 3 when set* 
Selects Side when reset 
Selects Side 1 when set 
Write precompensation enabled 
when set, disabled when reset 
Generates WAIT if set 
Selects MFM mode if set 
Selects FM mode if reset 



*Only one of these bits should be set per output 

A hex D flip-flop (U5) latches the drive select bits, side 
select and FM*/MFM bits on the rising edge of the control 
signal IDRVSEL*. A dual D flip-flop (U15) is used to latch 
the Wait Enable and Write precompensation enable bits on 
the rising edge of IDRVSEL*. The rising edge of IDRVSEL* 
also triggers a one-shot (1/2 of U13) which produces a Motor 
On to the disk drives. The duration of the Motor On signal 
is approximately two seconds. The spindle motors are not 
designed for continuous operation, therefore the inactive 
state of the Motor On signal is used to clear the Drive 
Select Latch, which de-selects any drives which were pre- 
viously selected. The Motor On one-shot is retriggerable 
by simply executing another OUT instruction to the 
Drive Select Latch. 

4.2.4 Wait State Generation and WAITIPVIOUT Logic 

As previously mentioned, a wait state to the CPU can be 
initiated by an OUT to the Drive Select Latch with D6 set. 
Pin 5 of U15 will go high after this operation. This signal 
is inverted by 1/6 of U1 and is routed to the CPU board 
where it forces the Z-80 into a wait state. The Z-80 will 
remain in the wait state as long as WAIT* is low. Once 
initiated, the WAIT* will remain low until one of four 
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conditions is satisfied. One half of U9 (a five input NOR 
gate) is used to perform this function. INTO, DRQ, RESET, 
and WAITIMOUT are the inputs to the NOR gate. If any 
one of these inputs is active (logic high), the output of the 
NOR gate (U9 pin 6) will go low. This output is tied to the 
clear input of the wait latch. When this signal goes low, 
it will clear the Q output (U18 pin 5) and set the Q* output 
(U15 pin 6). This condition causes WAIT* to go high which 
allows the Z-80 to exit the wait state. U3 is a 12-bit binary 
counter which serves as a watchdog timer to insure that a 
wait condition will not persist long enough to destroy 
dynamic RAM contents. The counter is clocked by a 1 
MHz clock and is enabled to count when its reset pin is low 
(U3 pin 11). A logic high on U3 pin 11 resets the counter 
outputs. U3 pin 15 is a divide-by-1024 output and is used 
to generate the signal WAITIMOUT. This watchdog timer 
logic will limit the duration of a wait to 1024 /isec, even 
if the FDC chip should fail to generate a DRQ or a INTRO. 

4.2.5 Clock Generation Logic 

A 4 MHz crystal oscillator and a 4-bit binary counter are 
used to generate the clock signals required by the FDC 
board. The 4 MHz oscillator is implemented with two inver- 
ters (1/3 of U22) and a quartz crystal (Y1). The output of 
the oscillator is inverted and buffered by 1/6 of U22 to 
generate a TTL level square wave signal. U21 is a 4-bit 
binary counter which is divided into a divide-by-2 and 
a divide-by-8 section. The divide-by-2 section is used to 
generate the 2MHz output at pin 12. The 2 MHz is NANDED 
with a MHz by 1/4 of U17 and the output is used to clock 
the divide-by-8 section of U21. A 1 MHz clock is generated 
at pin 9 of U21 which is 90 degrees phase-shifted from the 2 
MHz clock. This phase relationship is used to gate the gua- 
ranty Write Data Pulse (WD) to the Write precompensation 
circuit. The 4 MHz is used to clock the digital data separator 
U11 and the Write precompensation shift register U10. The 
1 MHz clock is used to drive the clock input of the FDC 
chip (U6) and the clock input of the watchdog timer (U3). 

4.2.6 Disk Bus Selector Logic 

As mentioned previously, the Floppy Disk Controller board 
supports up to four drives (two internal and two external). 
This function is implemented by using two disk drive inter- 
face buses, one for the internal drives and one for the 
external drives. J1 is the edge connector used to drive the 
internal disk drives and J4 is the edge connector used to 
drive the external drives. U19 (a quad 2 to 1 data selector) 
is used to select which set of inputs is routed from the disk 
drive buses to the FDC chip. U19 pin 1 is the control pin for 
the data selector. If pin 1 is low, the external inputs are 
selected, otherwise the internal inputs are selected. This 
control signal EXTSEL* is generated from the outputs of 



the Drive Select Latch. If Drive 2 or 3 is selected, U20 pin 
1 will go low indicating that an external drive is selected. 
One half of U9 (a five-input NOR gate) is used to detect 
when any of the four drives is selected. 

The output of the NOR gate (U9 pin 5) is inverted and is 
used as the head load timing (HLT) and ready (RDY) signal 
for the FDC chip. Therefore, if any drive is selected, the 
head is assumed to be loaded and the selected drive is as- 
sumed to be ready. 

4.2.7 Disk Bus Output Drivers 

High current open collector drivers (U18, U8, and U1) are 
used to buffer the output signals from the FDC board to the 
disk drives. Note from the schematic that each output 
signal to the drives has two buffers associated with each 
signal. One set is used for the internal drive bus and the 
other set is used for the external drive bus. No select logic 
is required for these output signals since the drive select 
bits define which drive is active. 

4.2.8 Write Precompensation and Write Data Pulse Shaping 
Logic 

The Write Precompensation logic is comprised of U10 
(74LS195), 1/4 of U17, 1/4 of U20, and 1/2 of U15. U10 
is a parallel in, serial out shift register and is clocked by 4 
MHz which generates a precompensation value of 250 nsec. 
The output signals EARLY and LATE of the FDC chip (U6) 
are input to P0 and P2 of the shift register. A third signal is 
generated by 1/4 of U20 when neither EARLY nor LATE 
is active low and is input to P1 of U10. WD of the FDC chip 
is NANDed with 2 MHz to gate the guaranteed Write Data 
Pulse to U10 for the parallel load signal SHFT/LD. When 
U10 pin 9 is active low, the signals preset at P1-P3 are 
clocked in on the rising edge of the 4 MHz clock. After U10 
pin 9 goes high, the data is shifted out at a 250 nsec rate. 
EARLY will generate a 250 nsec delay, NOT EARLY AND 
NOT LATE will generate a 500 nsec delay, and LATE will 
generate a 750 nsec delay. This provides the necessary 
precompensation for the write data. As mentioned previous- 
ly, Write Precompensation is enabled through software 
by an OUT to the Drive Select Latch with bit 5 set. 
This sets the Q output of the 74LS74 (U15 pin 9) which 
disables the shift register U10. This signal also enables 
U20 to allow the write data (WD) to bypass the Write 
Precompensation circuit. The Write Date (WD) pulse is 
shaped by a one-shot (1/2 of U3) which stretches the data 
pulses to approximately 500 nsec. 

4.2.9 Clock and Read Data Recovery Logic 

The Clock and Read Data Recovery Logic is comprised of 
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one chip, the FDC9216. The FDC9216 is a Floppy Disk 
Data Separator (FDDS) which converts a single stream of 
pulses from the disk drive into separate clock and data 
pulses for input to the FDC chip. The FDDS consists of a 
clock divider, a long-term timing corrector, a short-term 
timing corrector, and reclocking circuitry. The reference 
clock (REFCLK) is 4 MHz and is divided by the internal 
clock divider. CDO and CD1 of the FDDS chip control the 
divisor which divides REFCLK. With CD1 grounded (logic 
low), CDO (when a logic low) generates a divide-by-1 for 
MFM mode and when logic high generates a divide-by -2 
for FM mode. CDO is controlled by the signal DDEN* 
which is Double Density Enable or MFM enable. The 
FDDS detects the leading edges of RD* pulses and adjusts 
the phase of the internal clock to genearte the separated 
clock (SEPCLK) to the FDC chip. The separate long and 
short term timing correctors assure the clock separation to 
be accurate. The separated Data (SEPD*) is used as the 
RDD* input to the FDC chip. 



4.2.10 Floppy Disk Controller Chip 

The 1793 is an MOS LSI device which performs the func- 
tions of a floppy disk formatter/controller in a single chip 
implementation. The 1793 is functionally identical to the 
1791 used on the Model II FDC Printer Interface Board 
except that the data bus is true as opposed to inverted. Refer 
to the appendix section for more information on the 
FD1793. The Model II Technical Reference Manual also 
contains a good presentation of the 1791 FDC chip as well 
as a discussion on Write precompensation. The following 
port addresses are assigned to the internal registers of the 
1793 FDC chip: 



Port # 

FOH 
F1H 
F2H 
F3H 



Function 

Command/Status Register 
Track Register 
Sector Register 
Data Register 
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Parts List, FDC PCB #8858160 



Item Qty Description 



Mfgr's Part No. 



1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 



1 
9 
1 
1 
1 
1 
1 
1 
3 
1 
1 
1 
2 
1 
11 

2 

4 
4 
2 
1 
1 
1 
3 
1 
1 
1 
1 
1 
1 
1 
1 
1 
2 
1 
1 
1 
1 
1 
1 
1 
1 



, Angle (J2) 
Angle (J3) 



Printed Circuit Board 

Staking Pin (TPl-9) 

Connector, 20-Pin Rt. 

Connector, 4-Pin Rt, 

Socket, 8-Pin (Ull) 

Socket, 40-Pin (U6) 

Resistor, 150 ohm 1/4W 5% (Rl) 

Resistor Pak, 150 ohm 6-Pin (R2) 

Resistor, 10K ohm 1/4W 5% (R3-5) 

Resistor, 270K ohm 1/4W 5% (R6 ) 

Resistor Pak, 150 ohm 10-Pin (R7) 

Resistor, 470 ohm 1/4W 5% (R8) 

Resistor, 910 ohm 1/4W 5% (R9,10) 

Resistor, 2.2K ohm 1/4W 5% (Rll) 

Capacitor, 0.1 ufd 50V (Cl , 5 , 7-9 , 11 , 13-15 , 

C17,18) 
Capacitor, 10 ufd 16V Elec. (C2,3) 

.022 ufd 50V (C4,6,22,23) 

180 pfd 50V C. Disk (C10, 19-21) 

100 pfd 50V C. Disk (C12,25) 

33 ufd 16V Elec. (C16) 

470 pfd 50V C. Disk (C24) 

000 MHz (YD 

7416 Hex Inverter Buffer (Ul,8,18) 

74LS245 Octal Bus Tranceiver (U2) 

MC14040 Binary Counter (U3) 

74LS244 Octal Buffer (U4) 

74LS174 Flip Flop (U5) 

1793 FDC (U6) 

74LS38 NAND Buffer (U7) 

74LS260 5-In NOR Gate (U9) 

74LS195 Shift Register (U10) 

9216 Data Separator (Ull) 

74LS74 Flip Flop (Ul2,15) 

74LS123 Mono Multiplier (U13) 

74LS367 Hex Buffer (U14) 

74LS368 Hex Inv. Buffer (U16) 

74LS00 NAND Gate (U17) 

74LS157 Quad Multiplier (U19) 

74LS02 NOR Gate (U20) 

74LS93 4-Bit Counter (U21) 

74LS04 Hex Inverter (U22) 



Capacitor, 

Capacitor, 

Capacitor, 

Capacitor, 

Capacitor, 

Crystal, 4 

IC, 

IC 

IC 

IC 

IC 

IC 

IC 

IC 

IC 

IC 

IC 

IC 

IC 

IC 

IC 

IC 

IC 

IC 

IC 



8709380 
8529014 
8519078 
8519079 
8509011 
8509002 
8207115 
8290012 
8207310 
8207427 
8290013 
8207147 
8207191 
8297222 
8374104 

8326101 
8303224 
8301184 
8301104 
8396331 
8301474 
8409010 
8000016 
8020245 
8030040 
8020244 
8020174 
8030793 
8020038 
8020260 
8020195 
8040216 
8020074 
8020123 
8020367 
8020368 
8020000 
8020157 
8020002 
8020093 
8020004 
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SECTION V 



MINI DISK DRIVE 
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5.1 MINI-DISK DRIVE #8790112 
(T.P.I 01-0053-001) 

5.1.1 Physical Description 

The electronic components of the Mini-Disk Drive are 
mounted on the Logic/Servo Board. This board is located 
above the chassis, and the power and interface signals are 
connected directly to it. 

The spindle is belt driven by a DC motor with an integral 
tachometer. The servo control circuit, pulleys and the 
tachometer control the speed of the spindle. The read/write/ 
erase head assembly is positioned by means of a stepper 
motor, split band and a pulley. 

5.1.2 Functional Description 

The Disk Drive is fully self-contained. It consists of a spindle 
drive system, a head positioning system, and read/write/erase 
system. 

When the front latch is opened, access is provided for the 
insertion of a 5Y* inch (133.4 mm) standard diskette. The 
diskette is positioned in place by plastic guides, the front 
latch and a back stop. 

Closing the front latch activates the cone/clamp system 
which centers and clamps the diskette to the drive hub. 
The drive hub is driven at a constant speed of 300 rpm by a 
servo controlled DC motor. In operation, the magnetic head 
is loaded into contact with the recording medium whenever 
the front latch is closed. 

A 4-phase stepper motor/band assembly and its associated 
electronics position the magnetic head over the desired 
track. This positioner employs a one-step rotation to cause 
a 1 -track linear movement. When a write-protected diskette 
is inserted into the Drive, the write-protect sensor disables 
the write electronics of the Drive and an appropriate signal 
is applied to the interface. (When performing a write opera- 
tion, a 0.013-inch (0.33 mm) [nominal] data track is re- 
corded.) 



Data recovery electronics include a low-level read amplifier, 
differentiator, zero-crossing detector and digitizing circuits. 
No data decoding facilities are provided in the basic Drive. 

The Drive is also supplied with the following sensor systems; 

1 . A track 00 switch which senses when the Head/ 
Carriage assembly is positioned at Track 00. 

2. The index sensor (an LED light source and a photo- 
transistor) is positioned so that when an index 
hole is detected, a digital signal is generated. The 
index sensor used is a high resolution device which 
can distinguish holes placed close together, i.e., in- 
dex-sector holes in a hard sectored diskette. 

3. The write-protect sensor disables the Disk Drive 
electronics whenever a write-protect tab is applied 
to the diskette. 

5.1.3 Interface Connections 

Signal connections for the external Disk Drive are made via 
a user-supplied 34-pin flat ribbon connector. The internal 
Drive uses a Radio Shack connector. Part Number AW2535. 
Both of these connectors mate directly with the PC Board 
connector J2 at the rear of the Drive. The DC power con- 
nector is a four - pin connector J4 on the PC Board on the 
top rear of the Drive. 

The signal connector harness should be of the flat ribbon or 
twisted pair type with the following characteristics: 

1. Maximum length of 10 feet (3 M). 

2. 22 - 24 gauge conductor compatible with the con- 
nector to be used. 

Power connections for external Drives should be made with 
18 AWG cable. Internal Drives use the Disk DC Power 
Harness, Radio Shack Part Number AW2532. 

5.1.4 Physical Checkout 

Before applying power to the unit, the following inspection 
should be performed: 

1 Front latch. Check that the front latch opens and 
closes. Note that when the door is opened, the 
head arm raises. 

2. Ensure that the front panel is secure. 

3. Manually rotate the drive hub. The hub should 
rotate freely. 

4. Check that the PC board is secure. Check that 
the connectors are firmly seated. 
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Media 


Industry-compatible 5-1/4 inch (133.4 


mm) diskette 


Tracks per inch 


48 




Number of Tracks 
Read/Write Track Width 


40 

.020 inches (5.08 mm) 




Dimensions 
Height 
Width 
Depth 
Weight 


3.38 inches (85.85 mm) 
5.87 inches (149.10 mm) 
8.0 inches (203.2 mm) 
4.5 lbs (2.04 Kg 




Temperature 

(Exclusive of Media) 

Operating 

Non-operating 


10°Cto43°C(50°Fto 110°F) 
-40°C to 71°C (-40°F to 160°F) 




Relative Humidity 

(Exclusive of Media) 

Operating 

Non-operating 


20% to 80% 

5% to 95% (non-condensing) 




Vibration 


6 to 600 Hz 0.5g peak 




Seek Time 


5 msec track to track 




Head Settling Time 


15 msec (last track addressed) 




Error Rate 


1 per 10 9 recoverable 

1 per 10 12 non-recoverable 




Head Life 


20,000 hours (normal use) 




Media Life 


3 million passes on a single track 




Disk Speed 


300 rpm±1.5% (long term) 




Instantaneous Speed Variation 


±3.0% 




Start/Stop Time 


250 msec (maximum) 




Transfer Rate 


125/250K bits/sec 




Bits/Disk (unformatted) 


1.75 million (FM) 




Recording Modes (typical) 


FM,MFM, MMFM 




Power 


+ 1 2 V dc ±0.6 V, 900 ma maximum 
5 V dc ±0.25 V, 600 ma maximum 





TABLE 5-1. MINI-DISK DRIVE MECHANICAL 

AND ELECTRICAL SPECIFICATIONS. 
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5. Check for debris or foreign material between the 
heads and remove same. 

6. Check plastics for broken or cracked pieces, e.g., 
write protect lever, guide rails, etc. 

NOTE: To ensure proper operation of the Drive, the chassis 
should be connected to earth ground. The 3/16-inch 
(4.76 mm) male QC lug, located at the rear of the chassis, 
is provided for this connection. 

5.1.5 Mounting The Disk Drive 

The Drive can be mounted in any plane, i.e., upright, hori- 
zontal or vertical. However, when it is mounted horizon- 
tally, the Logic PC board side of the chassis must be the 
uppermost side. Tapped holes are provided in various loca- 
tions for the attachment of user -supplied hardware. 



INTERNAL DRIVES 



DRIVE 
NUMBER ZERO 


DRIVE 
NUMBER ONE 


12 
14 
32 


10 
14 
32 



EXTERNAL DRIVES 



DRIVE 
NUMBER TWO 


DRIVE 
NUMBER THREE 


12 
14 
32 


10 
14 
32 



5.1.6 Flat Ribbon Cable Assembly 



FIGURE 5-1. CABLE ASSEMBLY - 
CONNECTOR PIN REMOVAL CHART 



The Flat Ribbon Cable Assembly that is used is the same 
one used in the Model I and III Computers. Pins must be 
removed from Drive connectors on the Cable Assembly 
as noted below: 

1 . Connector for the first internal drive (Drive 0) and 
the first external drive (Drive 2) pins 12, 14 and 
32. 



5.1.7 Resistor Termination 

The Resistor Termination in the SIP socket (R51) is used 
only in the last drive in the system. Remove all other 
Resistor Terminations. 



2. Connector for the second internal drive (Drive 1) 
and the second external drive (Drive 3), pins 10, 
14 and 32 



NOTE: The internal Drives in the Model 4 Com- 
puter are not terminated. 



Resistor Termination (in socket). 
Remove except for last Drive in 
System. 



There will be a small mark, or dot, 
or the number 1 on the left end of 
the SIP to indicate pin 1. Match 
pin 1 of the SIP to the number 1 
on the P.C. Board. 




FIGURE 5-2. RESISTOR TERMINATION 
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5.2 THEORY OF OPERATION 

5.2.1 Introduction 

The Disk Drive consists of the mechanical and electrical 
components necessary to record and read digital data on a 
diskette. DC power at ±12V and +5V (provided by the 
user for the external drives) is required for operation. 

5.2.2 Organization of The Disk Drive 

All electrical subassemblies in the Disk Drive are constructed 
with leads which terminate in 4 or 5 pin connectors, ena- 
bling the individual assemblies to be removed. 

The magnetic head is connected to the PC board via a cable 
terminating in a 5-pin female connector and its associated 
male socket which is located in close proximity to the read/ 
write data electronics. 

Interface signals and power are provided via connectors at 
the rear of the Drive. A detailed description of these signals 
is presented in Section 5.3 of this manual. 

5.2.3 Functional Block Diagram Description 

Figure 5-3 is a functional block diagram of the Disk Drive 
and should be referred to in conjunction with the following 
discussion: 

The Disk Drive consists of the following functional groups: 

* Index Pulse Shaper 

* Write Protect Sensor 

* Track 00 Sensor 

* Spindle Drive Control 

* Carriage Position Control 

* Write/Erase Control 

* Read Amplifier and Digitizer 

5.2.4 INDEX 

An index pulse is provided to the user system via the 
INDEX PULSE interface line. The index circuitry consists 
of an Index LED, Index Phototransistor and a Pulse Shaping 
Network. As the index hole in the disk passes the Index 
LED/Phototransistor combination, light from the LED 



strikes the Index Phototransistor, causing it to conduct. 
The signal from the Index Phototransistor is then passed to 
the Pulse Shaping Network which produces a pulse for each 
hole detected. This pulse is presented to the user on the 
INDEX PULSE interface line. 

5.2.5 Write Protect 

A Write Protect signal is provided to the user system via the 
WRITE PROTECT interface line. The write protect circuitry 
consists of a Write Protect Sensor and circuitry to route the 
signal produced. 

When a write protected diskette is inserted in the drive, the 
sensor is activated and the logic disables the write elect- 
ronics and supplies the status signal to the Interface. 

5.2.6 Track 00 Switch 

The level on the TRACK 00 interface line is a function of 
the position of the magnetic head assembly. When the head 
is positioned at Track 00 and the stepper motor is at the 
home position, a true level is generated and sent to the 
user. 

5.2.7 Spindle Drive 

The Spindle Drive system consists of a spindle assembly 
driven by a DC motor-tachometer combination through a 
drive belt. 

Associated with the spindle drive motor are the servo elec- 
tronics required for control. 

The control circuitry also includes a current limiter and an 
interface control line. When the DRIVE MOTOR ENABLE 
interface line is true, the drive motor is allowed to come up 
to speed. When the current through the drive motor exceeds 
1 .3 A, the current limit circuitry disables the motor drive. 

5.2.8 Positioner Control 

The Head Positioning system utilizes a four-phase stepper 
motor drive which changes one phase for each track ad- 
vancement of the Read/Write carriage. In addition to the 
logic necessary for motion control, a gate is provided as an 
element for inhibiting positioner motion during a write 
operation. 
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FIGURE 5-3. FUNCTIONAL BLOCK DIAGRAM 



5.2.9 Data Electronics 

Information can be recorded on the diskette using a double- 
frequency code. Figure 5-4 illustrates the magnetization 
profiles in each bit cell for the number sequence 
shown. 

The erase gaps provide an erased guard band on either side 
of the recorded track. This accommodates the tolerances 
in track positioning. 



All signals required to control the data electronics are pro- 
vided by the user system and are shown in the Block Dia- 
gram (Figure 5-3). These control signals are: 

* SELECT 

* WRITE ENABLE 

* WRITE DATA 

The READ DATA composite signal is sent to the user 
system via the interface. 



BIT PATTERN 



MAGNETIZATION 



MAGNETIC ELEMENTS 




FIGURE 5-4. FM RECORDING 
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5.2.10 Data Recording 

Referring to Drawing 8790112 (page 97) it can be seen 
that the Write Electronics consists of a Write/Erase Current 
Source and Write Waveform Generator, Erase Current 
Source and Trim Erase Control Logic. 

The read/write winding on the magnetic head is center- 
tapped. During a write operation, current from the Write 
Current Source flows in alternate halves of the winding 
under control of the Write Waveform Generator. 

Before recording can begin, certain conditions must be 
satisfied. The conditions required for recording (i.e., unit 
ready) must be established by the user system as follows: 

(1) Drive speed stabilization. This condition will 
exist 250 mSec after starting the drive motor. 

(2) Subsequent to any step operation, the positioner 
must be allowed to settle. This requires 20 mSec 
total after the last step pulse is initiated, i.e., 
5 mSec for the step motion and 15 mSec for 
settling. 

NOTE: All of the foregoing operations can be overlapped, 
if required. 

Figure 5-5 shows the relevant timing diagram for a write 
operation. When t=0 , the unit is ready and the WRITE 
ENABLE interface line goes true, thus enabling the Write 
Current Source. 

Since the trim erase gaps are behind the read/write gap, 
TRIM ERASE control goes true 390MSec after the WRITE 
ENABLE interface line. It should be noted that this value 
is optimized between the requirements at Track 00 and 
Track 40 so that the effect of the trim erase gaps on pre- 
vious information is minimized. 

Figure 5-5 also shows the information on the WRITE 
DATA interface line and the output of the Write Waveform 
Generator which toggles on the leading edge of every 
WRITE DATA pulse. 

Note that a minimum of 4 /iSec and a maximum of 8 /iSec 
between WRITE ENABLE going true and the first WRITE 
DATA pulse is only required if faithful reproduction of the 
first WRITE DATA transition is significant. 

At the end of recording, at least one additional pulse on the 
WRITE DATA line must be inserted after the last significant 
WRITE DATA pulse to avoid excessive peak shift effects. 



The TRIM ERASE signal must remain true for 800juSec 
after the termination of WRITE ENABLE to ensure that all 
recorded data are trim erased. This value is again optimized 
between the requirements at Tracks 00 and 40. 

The duration of a write operation is from the true-going 
edge of WRITE ENABLE to the false-going edge of TRIM 
ERASE. This is indicated by the internal WRITE BUSY 
waveform shown. 

5.2.11 Data Reproduction 

The Read Electronics consists of the following: 

* Read Switch 

* Read Amplifier 

* Filter 

* Differentiator 

* Comparator and Digitizer 

The Read Switch consists of two FETs that are used to 
isolate the Read Amplifier from electrical signals across 
the magnetic head during a Write operation. 

The remaining functions of the Read circuitry are con- 
tained in the MC3470 IC. 

Before reading can begin, the Drive must be in a ready con- 
dition. As with the data recording operation, this ready 
condition must be established by the user system. In addi- 
tion to the requirements established in Paragraph 5.2.10, 
DATA RECORDING, a 100jiSec delay must exist from the 
trailing edge of the TRIM ERASE signal to allow the Read 
Amplifier to settle after the transient caused by the Read 
Switch returning to the Read mode. 

Referring to Figure 5-6, the output signal from the read/ 
write head is amplified by a read amplifier and filtered to 
remove noise by a Linear Phase Filter. The linear output 
from the Filter is passed to the Differentiator which gener- 
ates a waveform whose zero crossovers correspond to the 
peaks of the read signal. This signal is then fed to the Com- 
parator and Digitizer circuit. Variable resistor R22 is used 
to balance the Comparator and Differentiator by adjusting 
out any circuit imbalances and reducing peak shift. 

The Comparator and Digitizer circuitry generates a 1 /iSec 
READ DATA pulse corresponding to each peak of the read 
signal. This Composite Read Data signal is then sent to the 
user system via the READ DATA interface line. 
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WRITE ENABLE 



TRIM ERASE 

INTERNAL 
WRITE BUSY 

NWRITEDATA 

WRITE 

WAVEFORM 

GENERATOR 



WRITE CURRENT 




NOTES: 

1 t = = 250 MILLISECONDS AFTER DRIVE MOTOR 
STARTS, OR 20 MILLISECONDS AFTER LAST STEP 
PULSEIWHICHEVER IS THE LATEST TIME). 



2. UNSYNCHRONIZED 

3. 8,5 MA PEAK TO PEAK 

4. 4 jjSECONDS MINIMUM. 8 ^SECONDS MAXIMUM 



FIGURE 5-5. WRITE TIMING DIAGRAM 



, NOTE 1 



LINEAR OUTPUT FROM FILTER 



OUTPUT FROM DIFFERENTIATOR \ 



READ DATA INTERFACE 




t = 



NOTES: 

t = = 250 MILLISECONDS AFTER DRIVE MOTOR STARTS, 
OR 20 MILLISECONDS AFTER STEP COMMAND, OR 
100MSECONDS AFTER TERMINATION OF WRITE 
BUSY (WHICHEVER IS THE LATEST TIME) 



FIGURE 5-6. READ TIMING DIAGRAM 



87 



5.3 OPERATION 

5.3.1 Introduction 

This section contains the interface description and the elec- 
trical adjustments necessary for the Disk Drive. 

5.3.2 Interface Electronics Specifications 

All interface signals are TTL compatible. Logic true (low) is 
+ 0.4 V (maximum). Logic false (high) is +2.4 V (mini- 
mum). Figure 5-7 illustrates the interface configuration. 



-£°5 



X 



L M 1 



6 OR EQUIVALENT 



LENT 



RANSMISSION I 




FIGURE 5-7. INTERFACE CONFIGURATION 

It is recommended that the interface cable be a flat ribbon 
cable, with a characteristic impedance of 100 ohms (or 

equivalent twisted pairs). Maximum interface cable length 
is 10 feet (3 M). 

5.3.3 Input Control Lines 

Interface connector pin assignments and power connector 
pin assignments are given in Table 5-2 and Table 5-3. 

5.3.4 Select Lines (DSI* - DS4*) 



The SELECT lines provide a means of selecting and deselec- 
ting a Disk Drive. These four lines (DS1* - DS4*) select one 
of the four Disk Drives attached to the controller. When the 
signal logic level is true (low), the Disk Drive electronics are 
activated and the Drive is conditioned to respond to step 
or read/write commands. When the logic level is false (high) 
the input control lines and output status lines are disabled. 

A SELECT line must remain stable in the true (low) state 
until the execution of a step or read/write command is 
completed. 

The Disk Drive address is determined by SELECT lines 1 
through 4 on the PC board. These lines provide a means of 
daisy-chaining a maximum of four Disk Drives to a con- 
troller. Only one line can be true (low) at a time. An unde- 
fined operation might result if two or more units are 
assigned the same address or if two or more SELECT lines 
are in the true (low) state simultaneously. 



5.3.5 Drive Motor Enable 

When this signal line logic level goes true (low), the drive 
motor accelerates to its nominal speed of 300 rpm and stab- 
ilizes in less than 250 mSec. When the logic level goes false 
(high), the Disk Drive stops. 

5.3.6 Direction and Step (DIR*) (STEP*) 

When the Disk Drive is selected, a true (low) pulse with a 
time duration greater than 200 nSec on the STEP line initi- 
ates the access motion. The direction of motion is deter- 
mined by the logic state of the DIRECTION line when a 
STEP pulse is issued. The motion is towards the center of 
the disk if the DIRECTION line is in the true (low) state 
when a STEP pulse is issued. The direction of motion is 
away from the center of the disk if the DIRECTION line 
is in the false (high) state when a STEP pulse is issued. To 
ensure proper positioning, the DIRECTION line should be 
stable 0.1 juSec (minimum) before the trailing edge of the 
corresponding STEP pulse and remain stable until 0.1 jjSec 
after the trailing edge of the STEP pulse. The access motion 
is initiated on the trailing edge of the STEP pulse. 

5.3.7 Compensated Write Data (CWD) 

When the Disk Drive is selected, this interface line provides 
the bit-serial WRITE DATA pulses that control the switch- 
ing of the write current in the head. The write electronics 
must be conditioned for writing by the WRITE ENABLE 
line (refer to the WRITE ENABLE paragraph below). 

For each high-to-low transition on the WRITE DATA line, 
a flux change is produced at the head write gap. This causes 
a flux change to be stored on the disk. 

When the double-frequency type encoding technique is 
used (in which data and clock form the combined Write 
Data signal), it is recommended that when writing all 

zeroes, the repetition rate of the high-to-low transitions be 
equal to the nominal data rate, ±0.1%. The repetition rate 
of the high-to-low transitions, when writing all ones, should 
be equal to twice the nominal data rate, ±0.1%. 

5.3.8 Write Gate (WG*) 

When this signal is true (low), the write electronics are pre- 
pared for writing data (read electronics disabled). This 
signal turns on write current in the read/write head. Data is 
written under control of the WRITE DATA input line. It is 
generally recommended that changes of state on the 
WRITE ENABLE line occur before the first WRITE DATA 
pulse. However, the separation between the leading edge of 
WRITE ENABLE and the first significant WRITE DATA 
pulse should not be less than 4 jj.Sec and not greater than 
8 iiSec. The same restrictions exist for the relationship be- 
tween the least significant WRITE DATA pulse and the 
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Controller-to-Disk Drive 


Ground 


Signal 


Description (Mnemonic) 


1 


2 


Connector clamp 


3 


4 


(Spare) 


5 


6 


(Spare) 


9 


10 


SELECT 1 (NDS1) 


11 


12 


SELECT 2 (NDS2) 


13 


14 


SELECT 3 (NDS3) 


15 


16 


DRIVE-MOTOR ENABLE (NMOTORON) 


17 


18 


DIRECTION 


19 


20 


STEP (NSTEP) 


21 


22 


WRITE DATA (NWRITEDATA) 


23 


24 


WRITE GATE (NWRITEGATE) 


31 


32 


SELECT 4 (NDS4) 







Disk Drive 


-to -Controller 


Ground 


Signal 




Description (Mnemonic) 


7 


8 




INDEX (NINDEX/SECTOR) 


25 


26 




TRACK 00 (NTRK00) 


27 


28 




WRITE PROTECT (NWRITEPROTECT) 


29 


30 




READ DATA (NREADDATA) 


33 


34 




Connector Clamp 



TABLE 5-2. DISK DRIVE EDGE CARD PIN ASSIGNMENTS - J2. 



Pin 


Supply Voltage 


1 


+ 12 VDC 


2 


Return (+1 2 V DC) 


3 


Return (+5 V DC) 


4 


+5 VDC 



TABLE 5-3. POWER CONNECTOR 
PIN ASSIGNMENTS 
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termination of the WRITE ENABLE signal. When the 
WRITE ENABLE line is false (high), all write electronics 
are disabled. 

When a write protected diskette is installed in a Disk Drive. 
the write electronics are disabled regardless of the state of 
the WRITE ENABLE line. 



5.3.9 



Output Status 

(See Table 5-2) 



5.3.10 Index Pulse (IP*) 

The INDEX PULSE signal is provided once each revolution 
(200 mSec, nominal) to indicate to the controller the begin- 
ning of a track. The INDEX PULSE line remains in the true 
(low) state for the duration of the INDEX PULSE (The 
duration of an INDEX PULSE is nominally 4.0 mSec). 

The leading edge of an INDEX PULSE must always be used 
to ensure diskette interchangeability between Disk Drives. 

5.3.11 Track 00 (TRK0*) 

When the Disk Drive is selected, the TRACK 00 interface 
signal indicates to the controller that the read/write head is 
positioned at Track 00. The Track 00 remains true (low) 
until the head is moved away from Track 00. 



5.3.12 Write Protect (WPRT*) 

When the Disk Drive is selected, this signal line logic level 
goes true (low) when the diskette is write protected. The 
write electronics are internally disabled when the diskette 
is write protected. 

NOTE: It is recommended that the write data line be in- 
active whenever Write Enable is false (i.e., read state). 

When the level on this line is false (high), the write electron- 
ics are enabled and the write operation can be performed. It 
is recommended that the controller not issue a write com- 
mand when the WRITE PROTECT signal is true (low). 

5.3.13 Read Data (RD*) 

This interface line transmits the readback data to the con- 
troller when the Drive is selected. It provides a pulse for 
each flux transition recorded on the medium. The READ 
DATA output line goes true (low) for a duration of 1 //Sec 
for each flux change recorded. 

The leading edge of the READ DATA output pulse repre- 
sents the true positions for the flux transitions on the disk- 
ette surface. 
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5.4. MAINTENANCE 

5.4.1 Physical Description Of The PC Board 

The Logic PC board is approximately 6 inches (152 mm) 
long by 5.5 inches (139 mm) wide. Figure 5-8 illustrates 
the placement of test points and connectors. 

INSTALLATION 

To replace the Logic P.C. Board and the Servo P.C. Board 
with the newer Logic/Servo P.C. Board, the following steps 
should be taken: 

1. Discard the jumper cable that goes from P13 on 
the Logic P.C. Board to P20 on the Servo P.C. 
Board. 

2. Disconnect all cables that connect the two Boards. 

3. Remove both the Logic and the Servo P.C. Boards 
and the Servo P.C. Board mounting hardware. 

4. Connect all cables except the Drive Motor Cable 
that was connected to P21 on the Servo P.C. 
Board. 

5. Connect the Drive Motor Cable to P13 on the 
Logic/Servo P.C. Board. 

6. Go through the maintenance checks again. Pay 
particular attention to 5.5.1, DRIVE MOTOR 
MAINTENANCE and 5.5.8, PEAK SHIFT COM- 
PENSATION ADJUSTMENT. 

5.4.2 Circuit Board Test Points 

The following test point description assumes that the Logic 
and Servo P.C, boards are installed in the Drive and that the 
Drive is in an operational mode with a diskette installed: 

Analog Ground (TP1) 

The analog ground reference point is provided for measur- 
ing read/write waveforms. 

Amplified Read Signal (TP2, TP3) 

These test points are provided to observe the differential 
output of the first stage of read signal amplification. 

Logic Ground (TP4) 

Digital Logic ground is referenced at TP4. 

Track 00 (TP5) 

This signal is low (true) when the carriage is positioned at 
track 00 and the step motor phase is correct. 



Step Pulse (TP6) 

When stepping in or out, the signal is a high - going pulse 
for each step of the carriage. 

Read Data One Shot (TP7) 

The output of the one shot used in the read section is nom- 
inally 1 .0 /usee for each flux transition detected. 

Write Protect Switch (TP8) 

When a write protected diskette is installed in the Drive, the 
signal is low (true). 

Index Pulse (TP9) 

With a standard soft sectored diskette installed, the signal 
is a high going - pulse, nominally 4.0 msec in duration every 
200 msec. 

Motor On (TP11) 

This signal is low (true) for the Motor On condition. 

5.4.3 Option Select 

Input Line Terminations 

The Disk Drive has been provided with the capability of 
terminating the input lines listed below: 

* Motor On 

* Direction Select 

* Step 

* Write Data 

* Write Gate 

These lines are terminated through a 150 ohm resistor pack 
that is installed in a SIP socket (R51), located adjacent to 
J2. 

In a multiple drive system, only the last drive on the inter- 
face is to be terminated. All other drives on the interface 
must have the resistor pack removed. Catalog Numbers 
26-1160 and 26-1164 are shipped with the termination 
resistor installed. Catalog Numbers 26-1 161/1162/1163 are 
shipped without a resistor pack. 
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Jl READ/WRITE 
HEAD CONNECTOR 



R22 PEAK SHIFT 
COMPENSATION 
ADJUSTMENT 



J1 



HR54 



• TP4 
© TP6 



9 
TP2 TP3 

© 

TP1 



TP5 

9 



R22 

TP7 • 

TP8 • 



R51 TERMINATOR 
SIP SOCKET 




® TP11 



TP10 

9 



R54 SPINDLE 
SPEED CONTROL 
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FIGURE 5-8. LOGIC/SERVO PC BOARD TEST POINTS 
AND CONNECTOR LOCATIONS 
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5.4.4 Preventive Maintenance 



Instantaneous Speed Variation Check/RAW Data Check 



To ensure that the Disk Drive operates at its design poten- 
tial, the only scheduled preventive maintenance required is 
periodic cleaning of the magnetic recording head. 

Mechanical and electrical adjustment details are provided 
for further service as a result of disassembly or repair. 



5.4.5 Cleaning The Head 

To clean the magnetic head, we recommend using Radio 
Shack's Universal Disk Drive Head Cleaning Kit, catalog 
number 26-407. This kit comes with complete 
instructions for safely cleaning the disk drive heads. 

CAUTION: Rough or abrasive cloth should not be used to 
clean the magnetic recording head. Use of cleaning solvents 
other than 91% Isopropyl alcohol may damage the head. 

Extreme care must be exercised to prevent the heads from 
being damaged (i.e., scratching, banging together, etc.). 



5.5 ALIGNMENT AND ADJUSTMENT 

To perform the alignment and adjustment procedures, 
you will require the following equipment: 

* 30 MHz Dual Trace Triggered Sweep Scope 

* 5 1/4" Alignment Diskette 

* 5 1/4" Blank "scratch" Diskette 



1. With a blank diskette inserted, write a 2F pattern 
on any track. 



2. Connect scope to TP 7 with: 



Vert, to 2 volts/div. 
Time Base to 1 /isec/div. 
Trigger internal/positive 

Observe the waveform. Measure jitter on the lead- 
ing edge of the third pulse. The leading edge of the 
pulse should start 8 //sec ±240 nsec from the trig- 
ger pulse. The third pulse jitter should be less than 
480 nsec (edge to edge). 

/ / 480nsec 



/ 



8jnsec 



-rj 



4. If jitter is excessive, repair or replace the drive 
belt, the motor, the Servo PC Board, or the spindle 
as necessary. 

5.5.2 Carriage Movement Check 

1 . Step between tracks 00 and 34/40. 

2. Check carriage movement. Be certain that carriage 
is moving freely and not binding at any point. 
Repair if necessary. 



5.5.1 Drive Motor Maintenance 
Long Term Motor Speed Adjustment 

1. Check power to unit. (+12 VDC ± 0.6V, and 
+5 VDC ± 0.25V.) 

2. Insert a blank diskette and activate the drive. 

3. Under fluorescent lighting, observe the speed disk 
on the spindle pulley. For 60 Hz operation, the 
outer ring on the speed disk should appear station- 
ary. For 50 Hz operation, the inner ring should 
appear stationary. 

4. If the speed disk does not seem to be motionless, 
adjust R54 (located in the upper right corner of 
the PC Board) for the desired effect. 

5. If motor speed cannot be adjusted, repair Servo 
PCB or motor as required. 
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5.5.3 Head Radial Alignment/CE Alignment 

1 . Insert a 5 1/4" alignment diskette. 

2. Connect Scope: 

Channel A to TP 2 
Channel B to TP 3 
Ground to TP 1 
Ext. Sync to TP 9 

Set mode to add (A + B) Invert B 
Vert, to 50 mV/div 
Trigger external - loosely. 

3. Read track 16 and verify the "cat eyes" pattern as 
shown in Figure 5-9. The smaller of the two 
"eyes" should not be less than 75% amplitude of 
the other. % = (small lobe/larger lobe) x 100. 



EQUAL AMPLITUDE 
(on Track 16) 



4. Step to track 
the pattern. 



Return to track 16 and re-verify 
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TIME SCALE = 20msoc Div 



5. Step to track 34/40 and return to track 16. Re- 
verify the "cat eyes" pattern. 

If Radial Needs Adjustment: 

a. Loosen the two retaining screws on back of the 
unit and the retaining screw on the carriage as- 
sembly. 

b. Turn the Adjustment Cam until the "cat eyes" 
pattern is within 75%. If the pattern does not 
come within spec, loosen the hex head screw on 
the collar of the stepper motor and rotate the 
stepper motor shaft until the "eyes" are to the 
75% level. Tighten the hex head screw and return 
to step a. 

c. Tighten all screws and recheck adjustment. 



FIGURE 5-9. "CAT EYES" PATTERN 



RETAINING 

SCREW 



ADJUSTMENT 
CAM 




STEPPER MOTOR 

RETAINING 

SCREW 



RETAINING 

SCREWS 




FIGURE 5-10. RADIAL ADJUSTMENT 
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5.5.4 Track 00 Alignment 

Track 00 Switch Setting 

This switch is set at the factory and glued into position so 
this will not be a routine adjustment. It will require adjust- 
ment only after switch replacement. The switch should be 
positioned at the front of the adjustment slot and the front 
screw tightened. Position the head at Track 2. Raise 
the rear of the switch until the switch contact is closed, 
then tighten the rear screw. Add a drop of Locktight 
420 to lock the adjustment into place. Check it for the 
following conditions: the switch should make (signal low) 
at Track 1 , and be off (signal high) at track 03. This may 
be checked at Plug 1 1 , pin 1 . 

Track 00 Stop 

A Track stop is incorporated into the bracket which 
attaches the guide rods at the rear of the Disk Drive assem- 
bly. This stop is not adjustable. 



Carriage Module 




Loosen and Adjust to actuate 
at Tract 88 



FIGURE 5-11. TRACK 00SWITCH ADJUSTMENT 



5.5.5 Write Protect Switch 

The write protect switch is a field-adjustable setting. The 
switch is located on the front right-hand corner of the 
drive. The two screws holding this switch are located on 
the outside of the chassis. To adjust the switch, loosen the 
rear screw and place a .010" shim at the top and inside 
of the rail slot. Lift the switch until contact is made with 
the shim, then tighten the rear screw. Check with a write- 
protected diskette for write protect action, and a non 
write-protected diskette to verify that the write protect 
switch is properly functioning. Attach the meter to Plug 8, 
pin 1 . The level should be low for a write-protected diskette 
and high for a non write-protected diskette. 



5.5.6 Index Sector Adjustment 

1. Set Scope: 

Vert, at 02 volts/div, 
Time Base 50 /zsec/div. 

2. Insert alignment diskette and read track 01. Scope 
display should show volts AC trace for 200/isec 
±50 /usee. If the waveform is outside of spec, loosen 
the index sector light mounting screw and adjust 
to spec. 

3. Open and close the Drive door and re -verify the 
index sector timing. 



■++++ +H4 44++- Hfr &Hf 



TIME SCALE =50«ec/OIV 



FIGURE 5-12. INDEX SECTOR TIMING 




SENSOR RETAINING SCREW 



ADJUSTMENT 



FIGURE 5-13. INDEX ADJUSTMENT 
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5.5.7 Head Amplitude/Compliance Check 

1. Insert a blank diskette and write a pattern to 
track 34. 

2. Set Scope: 

Time Base to 10/isec/div. 
Read the amplitude. 

3. Apply an additional 15 grams of pressure to the 
head load arm. (15 grams is approximately equal 
to the weight of a 25 cent piece.) 

4. Observe the amplitude. If it increases more than 
10%, the compliance needs to be adjusted. 

5. To adjust the compliance, loosen the two nuts 
that hold the head load arm in place. While mon- 
itoring the amplitude, move the arm until output 
is highest. Hold the arm in this position and tight- 
en the nuts. 

6. Re-verify compliance. If compliance cannot be 
adjusted properly, replace the head load arm. 



PEAK SHIFT COMPENSATION ADJUSTMENT 

R22 is adjusted as follows: 

1. With a blank diskette inserted, write a 2F pattern 
on the innermost track (track 39), 

2. Connect the 'scope to TP7 with: 

Vert, to 2 volts/div. 
Time Base to 1 yusec/div. 
Trigger internal/positive 

3. The waveform should look like this: 



/ - - - - 4 WSI 



^77- 



4. Adjust R22 to center the second pulse between 
the first and third pulses with a maximum jitter of 
240 nanoseconds. 



5.5.8 Final Check 

1. Use the drive to format and backup a blank disk- 
ette. 

2. Check the diskette in a known good drive. 



UPPER ARM 




FIGURE 5-14. UPPER ARM AND CARRIAGE 
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SCHEMATIC DIAGRAM, MINI-DISK DRIVE #8790112 (Sheet 1 of 2) 
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SCHEMATIC DIAGRAM, MINI-DISK DRIVE #8790112 (Sheet 2 of 2) 
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LOGIC BOARD (COMPONENT SIDE) 



COMPONENT LOCATION, LOGIC/SERVO PC BOARD #995050001 
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PARTS LIST 
Logic/Servo Controller Board #995050001 



Symbol Description 

PC Board (RevC) 



Manufacturer's 
Part Number 



CAPACITORS 



C1 

C2 

C3 

C4 

C5 

C6 

C7 

C8 

C9 

C10 

C11 

C12 

C13 

C14 

C15 

C16 

C17 

C18 

C19 

C20 

C21 

C22 

C23 

C24 

C25 

C26 

C27 

C28 

C29 

C30 

C31 

C32 

C33 

C34 

C35 

C36 

C37 

C38 

C39 



J1 
J2 
J3 
J4 
J5 



0.1 AiF,50 V,Z5U, Radial 

0.1 nF, 100 VDC, Polyester 

0.1 juF, 100 VDC, Polyester 

Not Used 

0.1 juF.50 V,Z5U, Radial 

0.47juF,50V,Z5U, Radial 

0.1 mF,50 V,Z5U, Radial 

0.1 /iF,50 V,Z5U, Radial 

0.47mF,50V,Z5U, Radial 

68pF,50V, Radial 

0.1 /xF,50V,Z5U, Radial 

0.1 ^F,50V,Z5U, Radial 

330 pF, 50 V, Radial 

0.47jmF,50 V,Z5U, Radial 

10 nF, 16 V, Electrolytic, Axial 

10 /jF, 16 V, Electrolytic, Axial 

470pF,50 V, Radial 

3300 pF, 100 V, Polyester 

10 mF, 16 V, Electrolytic, Axial 

10 /jF, 16 V, Electrolytic, Axial 

470 pF, 50 V, Radial 

0.01 nF, 63 V, Axial 

0.1 juF,50 V,Z5U, Radial 

0.1 /jF,50 V,Z5U, Radial 

10 ixF, 16 V, Electrolytic, Axial 

0.1 j^F,50 V,Z5U, Radial 

10 A<F, 16 V, Electrolytic, Axial 

0.022 mF, 50 V, Axial 

0.1 AiF, 100 VDC, Polyester 

10 ixF, 16 V, Electrolytic, Axial 

0.1 /zF,50 V,Z5U, Radial 

0.1 a<F,50 V,Z5U, Radial 

10 /uF, 16 V, Electrolytic, Axial 

0.1 mF,50 V,Z5U, Radial 

100 fiF, 16 V, Electrolytic, Axial 

100 mF, 16 V, Electrolytic, Axial 

10 mF, 16 V, Electrolytic, Axial 

0.1 A<F,50 V,Z5U, Radial 

330pF,50 V, Radial 

CONNECTORS 

Header, 5-pin, Right Angle 
On PC Board 

Header, 23-pin Right Angle 
Housing, 4-pin, PC Mount, Power 
Header, 5 -pin, Right Angle 



ACC104ZJCF 
ACC302KLGP 
ACC302KLGP 

ACC104ZJCF 

ACC474ZJCP 

ACC104ZJCF 

ACC104ZJCF 

ACC474ZJCP 

ACC680KJCP 

ACC104ZJCF 

ACC104ZJCF 

ACC331KJCP 

ACC474ZJCP 

ACC106WDAA 

ACC106WDAA 

ACC471KJCP 

ACC302KLGP 

ACC106WDAA 

ACC106WDAA 

ACC471KJCP 

ACC103KJHA 

ACC104ZJCF 

ACC104ZJCF 

ACC106WDAA 

ACC104ZJCF 

ACC106WDAA 

ACC223KJCA 

ACC104JLGP 

ACC106WDAA 

ACC104ZJCF 

ACC104ZJCF 

ACC106WDAA 

ACC104ZJCF 

ACC107WDAA 

ACC107WDAA 

ACC106WDAA 

ACC104ZJCF 

ACC331KJCP 



AJ6815 

AJ7049 

ART2738 

AJ6815 



Radio Shack 
Part Number 

105050-001 



250002-610 
250001-233 
250001 -233 

250002-610 
250001 -647 
250002-610 
250002-610 
250001 -647 
250001 -068 
250002-610 
250002-610 
250001-133 
250001 -647 
261002-410 
261002-410 
250001-147 
250001 -233 
261002-410 
251002-410 
250001-147 
250102-210 
250002-610 
250002-610 
261002-410 
250002-610 
261002-410 
250002-722 
251002-610 
261002-410 
250002-610 
250002-610 
261002-410 
250002-610 
261002-310 
261002-310 
261002-410 
250002-610 
250001-133 



312000-005 

312000-023 
313000-004 
312000-005 
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Symbol 



CR1 



L1 
L2 
L3 
L4 



PARTS LIST (Cont'd) 
Logic/Servo Controller Board #995050001 



Manufacturer's 
Description Part Number 

DIODE 

1N5240B, 10%,Zener ADX1582 

INDUCTORS 



390/iH, 10%, Axial 
390 juH, 10%, Axial 
5.6 mH, 10%, Axial 
5.6 mH, Axial 



ACA8058 
ACA8058 
ACA8194 
ACA81 94 



INTEGRATED CIRCUITS 



Radio Shack 
Part Number 



600008-001 



461391-010 
461391-010 
461506-010 
461506-010 



U1 


74LS123 




AMX3803 


610002-123 


U2 


MC3470 




AMX4467 


610010-470 


U3 


74LS74 




AMX3558 


610002-074 


U4 


74LS26 




AMX4522 


610002-026 


U5 


7438 




AMX3683 


610002-038 


U6 


74LS11 




AMX3554 


610002-011 


U7 


74LS86 




AMX3701 


610002-086 


U8 


LM2917 




AMX4181 


610020-917 


U9 


74LS14 




AMX3716 


610002-014 


U10 


74LS14 




AMX3716 


610002-014 


U11 


74LS74 




AMX3558 


610002-074 


U12 


ULN2003A 




AMX4513 


610010-413 






RESISTORS 




R1 


62 ohms, 1/2 W, 5% 


AN0110EFC 


550003-062 


R2 


11 K, 1/4 W, 2% 




AN0285CEE 


540300-113 


R3 


24 K, 1/4 W, 2% 




AN0526CEE 


540300-243 


R4 


10 K, 1/4 W, 5% 




AN0281EEC 


550001-310 


R5 


2.2 K, 1/4 W, 5% 




AN0216EEC 


550001 -222 


R6 


2.2 K, 1/4 W, 5% 




AN0216EEC 


550001 -222 


R7 


4.7 K, 1/4 W, 5% 




AN0247EEC 


550001 -247 


R8 


475 ohms, 1/4 W, 


1% 


AN0627BEE 


540104-750 


R9 


330 ohms, 1/4 W, 


2% 


AN0159CEE 


540303-303 


R10 


475 ohms, 1/4 W, 


1% 


AN0627BEE 


540104-750 


R11 


768 ohms, 1/4 W, 


1% 


AN0572BEE 


540107-680 


R12 


768 ohms, 1/4 W, 


1% 


AN0572BEE 


540107-680 


R13 


Not Used 

1 K, 1/4 W, 5% 








R14 




AN0196EEC 


550001-210 


R17 


1 K, 1/4 W, 5% 




AN0196EEC 


550001-210 


R18 


470 ohms, 1/4 W, 5% 


AN0169EEC 


550001-147 


R19 


470 ohms, 1/4 W, 


5% 


AN0169EEC 


550001-147 


R20 


1 K, 1/4 W, 5% 




AN0196EEC 


550001-210 


R21 


1.8 K,1/4W,2% 




AN0210CEE 


540300-182 


R22 


50 K, Trimmer, 20% 


AP7211 


560150-302 


R23 


10 K, 1/4 W, 5% 




AN0281EEC 


550001-310 
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PARTS LIST (Cont'd) 
Logic/Servo Controller Board #995050001 







Manufacturer's 


Radio Shack 


Symbol 


Description 


Part Number 


Part Number 


R24 
R25 


Not Used 

10 K, 1/4 W, 5% 






AN0281 EEC 


550001 -310 


R26 


240 ohms, 1/4 W, 5% 


AN0151EEC 


550001-124 


R27 


240 ohms, 1/4 W, 5% 


AN0151EEC 


550001-124 


R28 
R29 


Not Used 

1 K, 1/4 W, 5% 






AN0196EEC 


550001-210 


R30 


1 K,1/4W,5% 


AN0196EEC 


550001-210 


R31 


1 K, 1/4 W, 5% 


AN0196EEC 


550001-210 


R32 


ohms 


AJ6814 


550000-001 


R33 


3.3 K, 1/4 W, 2% 


AN0230CEE 


540300-332 


R34 


1 K, 1/4 W, 5% 


AN0196EEC 


550001-210 


R35 


150 K, 1/4 W, 2% 


AN0384CEE 


540301 -503 


R36 


470 ohms, 1/4 W, 5% 


AN0169EEC 


550001-147 


R37 


1 M, 1/4 W, 5% 


AN0445EEC 


550001-510 


R38 


3.3 K, 1/4 W, 2% 


AN0230CEE 


540300-332 


R39 


470 ohms, 1/4 W, 5% 


AN0169EEC 


550001-147 


R40 


1 M, 1/4 W, 5% 


AN0445EEC 


550001-510 


R41 


10 K,1/4W,5% 


AN0281EEC 


550001 -310 


R42 


1.5 K,1/4W, 5% 


AN0206EEC 


550001-215 


R43 


150 ohms, 1/4 W, 5% 


AN0384CEE 


540301 -503 


R44 


10 ohms, 1/4W,5% 


AN0063EEC 


550001-010 


R45 


1 ohm, 1/2 W, 5% 


AN0022EFC 


550003-001 


R46 


1 K, 1/4 W, 5% 


AN0196EEC 


550001-210 


R47 


1 K, 1/4 W, 5% 


AN0196EEC 


550001-210 


R48 


2.2 K,1/4W,5% 


AN0216EEC 


550001 -222 


R49 


1 K, 1/4 W, 5% 


AN0196EEC 


550001-210 


R50 


20 K,1/4W,5% 


AN0306EEC 


550001 -320 


R51 


150 ohms, 6-pin SIP 


ARX0241 


570004-001 


R52 


56 ohms, 1/4 W, 5% 


AN0013EEC 


550001 056 


R53 


150 ohms, 1/4 W, 5% 


AN0142EEC 


550001-151 


R54 


1 K, Trimmer, 10% 


AP7210 


561501-301 


R55 


2.2 K,1/4W,5% 


AN0216EEC 


550001 -222 


R56 


150 ohms, 1/4 W, 5% 

TRANSISTORS 


AN0142EEC 


550001-151 


Q1 


MPS3906 


AMX3584 


630007-001 


Q2 


MPS3906 


AMX3584 


630007-001 


Q3 


MPS3906 


AMX3584 


630007-001 


Q4 


MPS2907 


AMX4187 


630008-907 


Q5 


2N5460, FET 


AMX4782 


630006-001 


Q6 


2N5460, FET 


AMX4782 


630006-001 


Q7 


TIP1 10, Power 


AMX4331 


630003-110 


Q8 


2N4124 


AMX4178 


630002-001 


Q9 


2N4124 


AMX4178 


630002-001 
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PARTS LIST (Cont'd) 
Logic/Servo Controller Board #995050001 



Symbol 



Description 



Manufacturer's 
Part Number 



Radio Shack 
Part Number 



MISCELLANEOUS 



TP1 
TP2 
TP3 
TP4 
TP5 

TP11 
(Q7) 
(07) 
(Q7) 

(R51) 


Staking Pin 
Staking Pin 
Not Used 
Not Used 
Staking Pin 

Staking Pin 

Heat Sink, TO220 

Screw, 4-40 x 3/8", Phillips 

Nut, 4-40 

Socket, 6-pin, SIP 


AHB9682 
AHB9682 


310024-001 
310024-001 






AHB9682 
AHB9682 


310024-001 

310024-001 
405351-001 
411351-406 
410020-001 
311500-006 


AHD2249 

AHD7227 

AJ7048 
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DISK DRIVE #8790112 (TPI #01-0053-001) 
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Parts List, Mini-Disk Drive Assembly #8790112 
(TPI #01-0053-001) 



Item 


. Quan 


Mfg. Part N 


1 


1 


995010603 


2 


1 


105310001 


3 


1 


995015003 


4 


1 


105157001 


5 


1 


400007001 


6 


1 


995223003 


7 


1 


995103011 


8 


1 


995111003 


9 


1 


105324001 


10 


1 


105166001 


11 


1 


105626001 


12 


1 


105155001 


13 


1 


450007001 


14 


1 


995102003 


15 


1 


450004001 


16 


1 


105626002 


17 


1 


105304001 


18 


1 


400009001 


19 


1 


995222003 


20 


2 


105333001 


21 


AR 


400014001 


22 


1 


105355001 


23 


1 


995101003 


24 


1 


105331001 


25 


1 


400006001 


26 


1 






1 


105002001 




1 


105027001 




1 


105320001 




1 


105360001 


27 


1 


105901001 


28 


2 


105322001 


29 


1 


105356001 


30 


5 


310016001 




1 


310015001 
310017001 


31 


1 


995324001 


32 


1 


995234001 


33 


1 


105330001 


34 


1 


105336001 


35 


1 


105312001 


36 


1 


105313001 


37 


1 


105335001 


38 


1 


105314001 


39 


1 


995050001 



Description RS PN 

Front Panel Assembly- 
Carriage Module 
Left Hand Guide Rail Assembly 
Right Hand Guide 8852023 

Nut Plate, #2-56 

Write Protect Switch Assembly 8852017 
Index Assembly (two parts) 
Timing Pulley Assembly 
Spring, Module Bias 
Cone, Thrust 
Spring, Cone Release 
Expander 

Belt, Drive 8852018 

Drive Motor Assembly 8852015 

Bearing, Cone 
Spring, Cone 
Spacer , Cone 
Washer, Shoulder 
Track Switch Assembly 
Shaft, Carriage 
Washer, Nylon 
Chassis 

Hub & Shaft Assembly 
Cone, Shaft 
E-Ring, .147" Shaft 
Latch Plate Assembly 
. Latch Plate 
. Hinge, Latch Plate 
. Latch Inhibitor 
. Brass Pin 

Foam Tape Strip 8852063 

Spring, Cone Lever 
Lever , Cone 

Connector, 4-Hole Molex 
Connector, 5-Hole Molex 

. Terminal Pin 8852046 

Upper Arm Assembly 8852044 

Head Carriage Assembly 8852031 

Drive Band 8852032 

Clamp, Shaft 8852064 

Pulley, Stepper 

Collar 8852047 

Track 00 Stop Clamp 

Cam Screw, Carriage Module 8852058 
Logic/Servo PCB Assembly 



8852016 
8852065 



8852050 



105 



Parts List, Mini-Disk Drive Assembly #8790112 
(TPI #01-0053-001) 



Item Quan Mfg. Part No, 



Description 



RS PN 



40 


2 


325500001 


41 


2 


409545632 


42 


1 


995304001 


43 


1 


310018001 


44 


3 


410002007 


45 


3 


410024001 


46 


1 


410038001 


47 


4 


410024001 


48 


1 


410009001 


49 


3 


417323208 


50 


2 


400001004 


51 


4 


410008001 


52 


1 


400011001 


53 


1 


410012001 


54 


1 


410006042 


55 


2 


410008001 


56 


2 


419351605 


57 


2 


410013001 


58 


1 


410021001 


59 


2 


414310605 


60 


2 


400188225 


61 


2 


410001007 


62 


2 


404351001 


63 


2 


410020001 


64 


2 


410011001 



Rivet, Plastic 
Clip, Tinnerman 
Stepper Motor Assembly 
Ground Lug 
Screw, #6-32 x .375" 
Washer, #6 Flat 
Screw, #2-56 x 7/16" 
Washer, #2 Flat 
Screw, #6-32 x 3/8" 
Screw, #2-56 x 1/2" 
Screw, #6 Hex Head 
Screw, #6-32 x 1/4" 
E-Ring, Cam Screw 
Screw, #8-32 x 1/4" 
Washer, #8 Split Lock 
Screw, #6-32 x 1/4" 
Screw, #6-32 x 5/16" 
Screw, #4-40 x 3/16" 
Nut, #2-56 

Screw, #6-32 x .312" 
Washer, #2 Flat 
Screw, #2-56 x .312" 
Washer, #4 Starlock 
Nut, #4 x .245" AF 
Screw, #6-32 x 3/16" 



8852056 
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SECTION ¥1 



POWER SUPPLY 
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6.1 POWER SUPPLY #8790021, 38W 
(ASTEC#AA11320) 



6.1.1 General 

One of the power supplies used in the Model 4 is a 38W 
switching mode power supply utilizing the flyback method 
of power conversion. This supply has built-in EMI filter 
and has over-voltage and over-current protection as well as 
regulation over line and load variations. 

6.1.2 Theory Of Operation 

PRIMARY 

Power is taken from a 115 volt AC line. A UL approved 
fusable resistor, R25, limits inrush current as well as acting as 
a system fuse. The AC current is taken through an EMI 
filter which suppresses power supply and system noise that 
would otherwise be reflected back into the power lines. 



FEEDBACK AND CONTROL 

On this power supply the only regulated voltage is the +5 volt 
output. The +12 volt and -12 volt outputs are simply addi- 
tional secondary windings stacked on top of the +5 volt 
winding. They track the +5 voltage close enough to provide 
sufficient regulation to run the circuitry requiring +12 or 
-12 volts. 

The +5 volt output is fed into an error amplifier which com- 
pares it to a reference voltage. The output of this amplifier 
is fed into a control circuit which is magnetically coupled 
through T1 to the turn-off circuit. This output also controls 
the ON time of Q2 providing voltage regulation by variations 
of the duty-cycle. 

OVERVOLTAGE PROTECTION 



After the EMI filter, the signal goes to a full-wave bridge 
rectifier (DB1) then into a capacitive input filter. The com- 
bination of these last two items produces a 165 volt DC B+ 
line from which a DC-DC converter is run. 

The DC-DC converter consists of a transistor (Q2) which is 
used to chop the B+ line at approximately 20 kHz. D2, R9, 
C8, C9, and D3 are all part of a snubber network designed 
to protect Q2 as well as suppress ringing which would con- 
tribute to line conducted EMI. 



If a failure in the power supply causes the outputs to rise 
uncontrolled past a specified voltage limit, the power supply 
will automatically shut down. This is done by sensing the 
+5 volt output via a Zener diode. When the voltage limit is 
reached, the SCR is triggered and shorts the +12 volt output 
to ground. A short on any output will cause the supply to 
foldback and shut down. 



SECONDARY 

When the power transistor (Q2) is 'ON', energy is stored in 
the core of the power transformer (T2). The secondary 
windings are polarized so that the output rectifiers do not 
conduct while Q2 is ON. When Q2 turns 'OFF', it causes 
the transformer to 'flyback' which causes the polarity on 
the output windings of T2 to reverse, allowing the output 
rectifiers to conduct and deliver energy to the output and 
output capacitors. 



A pi filter consisting of capacitors on either side of a series 
filter choke is used to smooth the output waveform, deliver 
energy during the ON time, and reduce ripple. 
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SCHEMATIC DIAGRAM, POWER SUPPLY #8790021 
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PARTS LIST, POWER SUPPLY #8790021 (ASTEC #AA11320) 



SYMBOL 



DESCRIPTION 



CAPACITORS 



INTEGRATED CIRCUIT 



CI 
C2 
C3 
C4 
C5 
C6 
C7 
C8 
C9 
C10 
C1 1 
C12 
C13 
C14 
C15 
C16 
C17 
C18 
C19 
C20 
C21 



D1 
D2 
D3 
D4 
D5 
D6 
D7 
D8 
D9 
D10 
DB1 
Z1 



2200pF, 250V AC, metallized paper 
0.01juF, 1KV, ceramic 
2200pF, 250V AC, metallized paper 
0.22mF, 100V, polyester 
47/iF, 250V, electrolytic 
100/iF, 250V, electrolytic 
220/xF, 10V, electrolytic 
4500pF, 1KV, ceramic 
0.01/iF, 1KV, ceramic 
Q.22juF, 100V, polyester 
1000/zF, 25V, electrolytic 
1000;uF, 25V, electrolytic 
1000mF, 25V, electrolytic 
330mF, 16V, electrolytic 
2200mF, 16V, electrolytic 
330juF, 16V, electrolytic 
470/iF, 25V, electrolytic 
0.022mF, 50V, polyester 
0.22mF, 100V, polyester 
3900pF, 400V AC, ceramic 
0.1juF, 250V AC, metallized 

DIODES 

RGP10A, rectifier 
RGP10D, rectifier 
RGP10J, rectifier 
Rectifier assembly 
Rectifier assembly 
Rectifier assembly 
RGP15B, rectifier 
1N4606, silicon 
1N4606, silicon 
1N4606, silicon 
W06, bridge rectifier 
5.6V, 5%, 1W, zener 



IC1 



R1 
R2 
R3 
R4 
R5 
R6 
R7 
R8 
R9 
R10 
R11 
R12 
R13 
R14 
R15 
R16 
R17 
R18 
R19 
R20 
R21 
R22 
R23 
R24 
R25 
R26 
SCR1 



T1 
T2 



Regulator 

RESISTORS 

47 ohm, 5%, metal oxide film 
150K, 5%, carbon film 

1 K, 5%, carbon film 
Not used 

82 ohm, 5%, carbon film 

27 ohm, 5%, carbon film 

3.3 ohm, 5%, carbon film 

10 ohm, 5%, carbon film 

27 ohm, 5%, metal oxide film 

75 ohm, 5%, 1W, metal film 

270 ohm, 5%, carbon film 

82 ohm, 5%, carbon film 

270 ohm, 5%, carbon film 

8.2 ohm, 5%, carbon film 

560 ohm, 5%, carbon film 

56 ohm, 5%, carbon film 

56 ohm, 5%, carbon film 

12K, 5%, carbon film 

12 ohm, 5%, carbon film 

470 ohm, 5%, carbon film 

2.7K, 2%, metal film 

2.7K, 2%, metal film 

68K, 5%, carbon film 

220 ohm, 5%, 1W, metal oxide film 

2 ohm, 5%, fusing metal film 
22K, 5%, carbon film 

SCR C122F 

TRANSFORMERS 

Control assembly 
Power assembly 



INDUCTORS 



TRANSISTORS 



L1 
L2 
L3 

L4 
L5 
L6 



Common mode choke assembly 

Base choke 

1 .5mH, choke 

Choke coil assembly 

Choke coil assembly 

Choke coil 



Q1 
Q2 
Q3 



PE8050B 

Transistor assembly 
PE8550B 
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6.2 Power Supply #8790043, 65 Watt (Astec AA12090) 

6.2.1 Test Set-Up 
A. Equipment Needed 

1. Isolation Transformer (minimum of 500 VA rating). 
Dangerously high voltages are present in this power 
supply. So, for the safety of the individual doing the 
testing, please use an isolation transformer. The 500 VA 
rating is needed to keep the AC waveform from being 
clipped off at the peaks. These power supplies have peak 
charging capacitors and draw full power at the peak of the 
AC waveform. 

2. 0-140 V Variable Transformer (Variac). Used to vary 
input voltage. Recommend 10 amp. 1.4 KVA rating 
minimum. 

3. Voltage meter — Needed to measure DC voltages to 50 
VDC and AC voltages to 200 VAC. Recommend two 
digital multimeters. 

4. Oscilloscope — Need x10 and x100 probes. 

5. Load board with connectors — See Table 6-1 for values 
of loads required. The entry on the table for safe load 
power is the minimum power rating for the load resis- 
tors used. 

6. Ohmmeter. 




AUTO TRANSFORMER 



POWER SUPPLY 




Figure 6-1. Test Set-Up 



6.2.2 Visual Inspection 

Check power supply for any broken, burned, or obviously 
damaged components. Visually check fuse, if any question 
check with ohmmeter. 

6.2.3 Start-Up 

Load power supply with minimum load as specified in Table I. 
Bring power up slowly with variable Transformer while 
monitoring +5V output with scope and DVM. Supply should 
start with approximately 40-60 VAC applied and should 
regulate when 90 VAC is reached. If output has reached +5 
volts, refer to the Performance Test section. If there is no 
output, refer to the No Output section. 



6.2.4 No Output 



General 



B. Set-Up Procedure 

Set up test equipment as shown in Figure 1. You will want to 
monitor the input voltage and the output voltage of the 
regulated bus, which is the +5V output, with DVM's. Also 
monitor the +5V output with the oscilloscope using 50mv/div 
sensitivity. The DVM monitoring the +5V output can also be 
used to check the other outputs. See the No Output section 
for test points within power supply. 



If the power supply does not produce an output with the AC 
input applied to the L and N connections and the power 
switch ON, one or more components have failed. A no-output- 
fault condition is most likely caused by a shorted/open 
component on the primary side but may also be caused by a 
short on the secondary. To determine this, follow the steps 
below. 

A. Check Fuse: 

If fuse is blown, replace but do not apply power until cause of 
failure is found. 



B. Preliminary Check on Major Primary Components: 

Check Diode Bridge (DB1), Power Transistor (Q2) and Catch 
Diode (D3) for shorted junctions. If any component is found 
shorted, replace. 
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C. Primary Check on Major Secondary Components 



6.2.5 Low Outputs 



Using Ohmmeter from output common to each output, with 
output loads disconnected, check for shorted rectifiers or 
capacitors. If +12V output is shorted, also check crowbar SCR 
(SCR I). 



A. All outputs are Low 

If all outputs are low at the same time, check to ensure that 
the voltage selection jumper is in the proper position. 



D. Check B+ with the Fuse Intact 



B. +5V and +12V <V3) Outputs 



Connect power supply as in Figure 1 and attach x100 scope 
probe ground to the anode of D1. Slowly turn up power and 
check for B+ on end of R14 nearest the transformer. With 
input at 95 VAC, this point should be between 260 and 270 
VDC. If this is not correct, check resistor and DB 1 . 

If R14 is open it was most likely caused by a shorted 
component that is fed power by R14. Check the following 
components for proper operation (Q2, Q1, D1, D3). 

E. Check 0.2 Waveforms 



The power supply regulates off of the +5V and +12V (V3) 
outputs. If these outputs are low, it could cause the others to 
be low. If so, adjust +5V and +12V (V3) outputs by removing 
or adding R27 and R28. 

C. Rectifier Check 

If any one output is not present, first check the rectifier 
associated with that output and then the rest of the 
components in the circuit and the solder joints on the PCB. 



Using x100 probe on Q2 heat sink, check collector waveform. 
Transistor should be switching, correct waveform is shown in 
Figure 2. 

If this is not present check for open junctions on Q2. If Q2 is 
ok, check to see if base voltage is being supplied to Q2, it 
should be 0.7 volts. If it is not present, check components (L3, 
Q1,D1,and R4). 



6.2.6 Crowbar 

If the crowbar is not operating, check Z1 and SCR1. If the 
crowbar is not triggering within the specified limits, change 
Z1. 



}--— I — 



50 V/DIV 
5/isec/DIV 

Input - 120V AC 

Loads - +6 @ 2A 
+12<s> 1A 
-12@0.1A 



1.0 V/DIV 
5/£ec/DIV 

Input and Loads 
same as above. 















&t 








*««* 


^z 






J 




J 









Figure 6-2. Q2 Collector Waveform 



Figure 3-3. Q2 Base Waveform 
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6.2.7 Performance Test 

Each of these test conditions should be set up and noted to be 
within the limits specified in Table 6-2. 



Table 6-2. Voltage and Ripple Specifications 
Output Min Max Ripple (Max RP) 



Step 

1 
2 
3 
4 
5 
6 



Input +5V Load +12V(V2) +12V(V3) -12V 



90V AC 
132 
120 
120 
132 



Max Max 

Max Max 

Max Min 

Min Min 

Min Min 



Max 
Max 
Min 
Max 
Min 



Max 
Max 
Min 
Min 
Min 



Test Crowbar Limits. 



If the power supply does not pass the above tests, refer to 
Section 6.2.4 and 6.2.5. 

Table 6-1. Load Board Values 



+5V 
+12V 
+12V 
-12V 



Pin Assignments 



AC Input: 

TB1 
Pin 1 
Pin 2 



5V 


5.25 


1 1 .40V 


12.60 V 


1 1 .40V 


12.60 V 


-11.40V 


-12.60V 









Safe 










Min 


Load 


Load 


Max 


Load 


Load 


Output 


Load 


Resistance 


Power 


Load 


Resistance 


Power 


+5V 


1.35A 


3.7 ohms 


12.5W 


4.0A 


1.25 ohms 


50W 


+12V-V2 0.40A 


30 ohms 


10W 


2.1A 


5.7 ohms 


50W 


+12V-V3 0.60A 


20 ohms 


15 W 


1.5A 


8 ohms 


35W 


-12V 


OA 


1K ohms 


1 W 


0.1A 


120 ohms 


3W 



DC Output: 

TB2 
Pin 1 
Pin 2 
Pin 3 
Pin 4 
Pin 5 
Pin 6 



Line 
Neutral 



Common 
V2 +12V 



Key 
V4 
V3 
V3 



-12V 
+12V 
+12V 



50 MV 
120 MV 
120 MV 
120 MV 



Pin 7 
Pin 8 
Pin 9 
Pin 10 
Pin 11 
Pin 12 
Pin 13 



V3 +12V 
V1 +5V 
V1 +5V 
V1 +5V 
Common 
Common 
Common 



Mating Connectors are: 

Molex Japan Co. Ltd. 
AC Input (housing) 5239-09 
DC Output (housing) 5265-12 
Pin 5167 
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SCHEMATIC, POWER SUPPLY ASSEMBLY #8790043 (ASTEC AA12090) 
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COMPONENT LAYOUT #1700218, POWER SUPPLY ASSEMBLY #8790043 
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CIRCUIT TRACE #1700218, POWER SUPPLY ASSEMBLY #8790043 
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Part 


s List, Power Supply #8790043, (Astec AA12090) 


Item 


Sym 


Description 


Mfgr • s Part No. 






Capacitors 




1 


CI 


0.01 ufd, +/- 20%, 250VAC, MPR 


068-10300010-220 


2 


C2 


0.1 ufd, +/- 20%, 25 0VAC, MPR 


068-10400010-220 


3 


C3 


4700 pfd, +/- 20%, 400VAC, Ceramic 


055-47220001-189 


4 


C4 


4700 pfd, +/- 20%, 400VAC, Ceramic 


055-47220001-189 


5 


C5 


100 ufd, +/- 20%, 250V, Electro. 


057-10120170-141 


6 


C6 


47 ufd, +/- 20%, 250V, Electro. 


057-47020040-192 


7 


C7 


100 ufd, +/- 20%, 250V, Electro. 


007-10120170-141 


8 


C8 


47 ufd, +/- 20%, 250V, Electro. 


057-47020040-192 


9 


C9 


220 ufd, +/- 20%, 10V, Electro. 


057-22110300-190 


10 


CIO 


0.01 ufd, +/- 20%, 100V, Ceramic 


055-10382125-111 


11 


Cll 


470 pfd, +/- 20%, 3kV, Ceramic 


055-47167728-111 


12 


C12 


0.01 ufd, +/-20%, lkV, Ceramic 


055-10368925-111 


13 


C13 


0.01 ufd, +/- 20%, 250VAC, MPR 


068-10300010-220 


14 


C14 


0.22 ufd, +/- 10%, 100V, Polyester 


058-22400240-189 


15 


C15 


0.022 ufd, +/- 20%, 100V, Polyester 


058-22300080-220 


16 


C16 


0.22 ufd, +/- 10%, 100V, Polyester 


058-22400240-189 


17 


C17 


1000 ufd, +/- 20%, 16V, Electro. 


057-10220100-192 


18 


C18 


1000 ufd, +/-20%, 16V, Electro. 


057-10220100-192 


19 


C19 


1000 ufd, +/~20%, 16V, Electro. 


057-10220100-192 


20 


C20 


1000 ufd, +/- 20%, 16V, Electro. 


057-10220100-192 


21 


C21 


330 ufd, +/- 20%, 16V, Electro. 


057-33120120-192 


22 


C22 


2200 ufd, +/-20%, 16V, Electro. 


057-22220070-192 


23 


C23 


2200 ufd, +/-20%, 16V, Electro. 


057-22220070-192 


24 


C24 


2200 ufd, +/- 20%, 16V, Electro. 


057-22220070-192 


25 


C25 


330 ufd, +/-20%, 16V, Electro. 

Diodes 


057-33120120-192 


26 


Dl 


RGP10B 


226-10400070-118 


27 


D2 


RGP10J 


226-10400060-118 


28 


D3 


RGP10M 


226-10400100-118 


29 


D4 


RGP15B 


226-10100040-118 


30 


D5 


1N4606 


212-10700210-158 


31 


D6 


fleatsink Assembly 


853-60200650-000 


32 


D7 


Heats ink Assembly 


853-60200650-000 


33 


D8 


Heatsink Assembly 


853-60200650-000 


34 


D9 


RGP10B 


226-10400070-118 


35 


D10 


1N4606 


212-10700210-158 


36 


Dll 


1N4606 


212-10700210-158 


37 


D12 


1N4001GP 


226-10400080-118 


38 


Zl 


Zener, 5.6V, +/-5% § 40mA 


222-56086002-148 


39 


DB1 


Bridge Rectifier KBP10 

Fuse 


226-30500010-118 


40 


Fl 


Fuse 2.5A, 250V, 3AG 


084-00200060-217 
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Parts List, Power Supply #8790043, (Astec AA12090) 

Item Sym Description Mfgr's Part No. 

Inductors 

41 Ll Toroid 024-00000110-484 

42 L2 Toroid 124-00000110-484 

43 L3 Base Choke 2.2 uH 328-00100030-124 

44 L4 Choke 1.5 mH 328-00100010-124 

45 L5 Choke Coil 852-20100180-264 

46 L6 Choke Coil 852-20100180-264 

47 L7 Filter Choke Coil 852-10100370-264 

Resistors 

48 Rl 4 ohm, +/- 10%, Thermister 258-40970015-152 

49 R2 4 ohm, +/- 10%, Thermister 258-40970015-152 

50 R3 100K ohm, +/- 5%, 1W, Metal Film 247-10036054-156 

51 R4 100K ohm, +/-5%, 1W, Metal Film 247-10036054-156 

52 R5 33 ohm, +/-5%, 2W, Metal Oxide Film 248-33006063-189 

53 R6 820 ohm, +/-5% r 1/4W, Carbon Film 240-82106022-152 

54 R7 5.6 ohm, +/- 5%, 1/4W, Carbon Film 240-56906022-152 

55 R8 47 ohm, +/- 5%, 1/4W, Carbon Film 240-47006022-152 

56 R9 5.6 ohm, +/- 5%, 1/4W, Carbon Film 240-56906022-152 

57 R10 10 ohm, +/- 5%, 1/4W, Carbon Film 240-10006022-152 

58 Rll 0.47 ohm, +/-5%, 1W, Metal Film 247-04786054-156 

59 R12 5.6 ohm, +/- 5%, 1/4W, Carbon Film 240-56906022-152 

60 R13 120 ohm, +/-5%, 1W, Metal Oxide Film 248-12106052-189 

61 R14 1 ohm, +/- 5%, 1W, Metal Film 247-10086054-156 

62 R15 39 ohm, +/-5%, 1/4W, Carbon Film 240-39006022-152 

63 R16 270 ohm, +/-5%, 1/2W, Carbon Film 240-27106033-152 

64 R17 270 ohm, +/-5%, 1/2W, Carbon Film 240-27106033-152 

65 R18 8.2 ohm, +/-5%, 1/4W, Carbon Film 240-82906022-152 

66 R19 330 ohm, +/-5%, 1/4W, Carbon Film 240-33106022-152 

67 R20 56 ohm, +/-5%, 1/4W, Carbon Film 240-56006022-152 

68 R21 56 ohm, +/-5%, 1/4W, Carbon Film 240-56006022-152 

69 R22 12K ohm, +/-5%, 1/4W, Carbon Film 240-12306022-152 

70 R23 470 ohm, +/-5%, 1/4W, Carbon Film 240-47106022-152 

71 R24 4.7K ohm, +/-2%, 1/4W, Metal Film 247-47015022-189 

72 R25 22K ohm, +/-2%, 1/4W, Metal Film 247-22025022-189 

73 R26 2.7K ohm, +/-1%, 1/4W, Metal Film 247-27014022-189 

74 R27 100K ohm, +/-5%, 1/4W, Carbon Film 240-10406022-152 

75 R28 100K ohm, +/~5%, 1/4W, Carbon Film 240-10406022-152 

76 R29 12 ohm, +/~5%, 1/4W, Carbon Film 240-12006022-152 

Transformers 

77 Tl Common Mode 852-20200120-264 

78 T2 Power 852-10201340-000 

79 T3 Control 852-10201510-000 
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Parts List, Power Supply #8790043, (Astec AA12090) 

Item Sym Description Mfgr's Part No. 



209-11700460-120 
209-30200020-143 
210-11700350-120 
211-10800100-176 







Transistors 


80 


Ql 


NPN, SD467 


81 


Q2 


NPN, 2SC1358 


82 


Q3 


PNP, SB561 


83 


Q4 


Intergrated Circuit, TL431CLP 
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When the switch opens at time tb, the magnetic field of L 
instantly collapses and reverses polarity. At this moment, Vsw 
is equal to Vin plus the voltage across L just before the switch 
opened (also equal to Vin). Therefore, at the instant the 
magnetic field reverses polarity, Vsw = 2Vin. 



6.3 Power Supply #8790049, 65 Watt 
6.3.1 System Description 

Basic Principle 

A switching power supply circuit employs a high-speed 
semiconductor switch to control the storage and release of 
electrical energy in an inductor and provide regulated DC 
output voltages with a minimum loss of energy in heat- 
dissipating elements. There are several schemes for achieving 
this result which differ primarily in the arrangement of the 
basic circuit elements. These elements include a switch, an 
inductor, a rectifier, a capacitor and a DC voltage source. 

An arrangement well-suited for economical power supplies 
with rated power outputs under 100 watts is the FLYBACK 
CONVERTER shown in Figure 6-4. The waveforms in Figure 
6-5 are used to describe the operation of the Flyback Conver- 
ter circuit. For the purpose of this discussion we will assume 
that the duration of the "ON" time equals the duration of the 
"OFF" time. 




Figure 6-4. Basic Flyback Converter 

When the switch is closed (ON) at time ta, Vin is impressed 
across the primary winding of inductor L and the current Isw 
increases linearly from zero until the switch opens (OFF) at 
time tb. Note that Isec is zero while the switch is closed. This 
is because Vsec is negative with respect to Vo thus reverse- 
biasing diode D. Note that Vsw is also zero while the switch is 
closed. 



During the interval when the switch is open (tb to tc), the 
secondary voltage, Vsec, is a replica of the primary voltage 
Vsw. Diode D is now forward biased due to the polarity of the 
inductor windings and because the turns ratio, n, is such that: 

Vsec x n ) Vo 



This biasing replenishes the charge in capacitor C that was 
delivered to the load R during the ta-tb interval. This is the 
"flyback" interval and is so named because the inductor 
releases the energy stored in its magnetic field while the switch 
is OFF. 

Several other facts are illustrated by the waveforms of Figure 
6-5. First, the voltage across the switch Vsw decays exponen- 
tially from 2Vin to Vin during the "OFF" interval. This is 
because the inductor and the switch timing are adjusted to 
transfer all of the energy that was stored in the inductor while 
the switch was ON, into the secondary while the switch is 
OFF. (Observe that Isec DECREASES linearly with time to 
zero at the end of the "OFF" time period.) This is known as 
resetting the core. Thus, at time tc when the switch is ready to 
turn on again, the DC input voltage Vin is again available to 
charge the inductor. Also at this time, all currents in the 
inductor are zero. 

Second, since we have assumed that Isw increases linearly with 
time and that the ON and OFF time periods are equal (50% 
duty cycle), the average current in the primary, Isw (av), is 1/4 
the peak current Isw. Also, the average current in the 
secondary, which is equal to the load current lo, is 1/4 the 
peak current in the secondary. 

Third, the turns ratio is set by the ratio of the average primary 
voltage (Vsw) over a full cycle at its lowest value to the 
maximum permissible output voltage, Vo. The lowest Vsw 
value occurs at low AC line and maximum output load. In 
practice, the actual turns ratio, the ratio of peak-to-average 
voltages and currents, and the duty cycle may be adjusted to 
compensate for circuit losses. 

Fourth, notice the ringing or oscillation that appears on the 
peak portion of Vsw and Vsec. This oscillation occurs at the 
resonant frequency of the leakage inductance of the inductor 
L and the parasitic capacitance of the circuit. The parasitic 
capacitance includes the interwinding capacitance of the 
inductor and stray capacitance of the switch. If this oscillation 
is not damped by a suitable means, the peak voltages may 
easily exceed the breakdown rating of the switch or the 
insulation in the inductor. 
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a. Switch 
Timing 




3» time,microsec . 



9» time,microsec . 



5= time,microsec. 



5> time ,microsec . 



==. time,microsec . 



Figure 6-5. Waveforms for Figure 6-4. 



Block Diagram 

The basic circuit illustrated in Figure 64 can be divided into 
three functional blocks: Input DC supply, primary, and 
secondary. To make use of this model, we need to expand it to 
provide control for the switch timing and to include sufficient 
circuitry to satisfy performance and reliability specifications. 
The complete block diagram is shown in Figure 6-6. 
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Figure 6-6. Block Diagram 



The other blocks provide additional output voltages, add 
safety or protective features, reduce circuit noise, and develop 
signals for use by the control section. The control section 
continuously operates the bipolar transistor switch and varies 
the proportion of ON time to OFF time in response to changes 
in AC input line voltage or output load current. This is 
accomplished by feeding back a signal from the output 
terminals that instructs the control section to increase or 
decrease the ON time to compensate for a change in the 
output voltage. 



There are four secondary or output voltages in addition to the 
auxiliary supply: +5.05 volt, +12 volt CRT, +12 volt Disk, and 
-12 volt. The +5.05 and +12 DISK voltages are regulated by 
the control circuit response to the frequency compensated 
feedback control signal which comes from the load sense 
section. Since the load sensing occurs on the secondary side, 
an optional coupler circuit is necessary to provide safety 
isolation between the primary side common ground and the 
secondary side common ground. 



The DC voltage supply to the control section is controlled by 
the latch circuit when AC power is first applied to the power 
supply. A built-in timing circuit allows the input DC supply 
filter capacitor to become fully charged before power is 
applied to the control section. After the control section circuit 
starts and secondary voltages reach their regulated output 
levels, the auxiliary power supply provides the required DC 
voltage to operate the control section. The latch is reset when 
the current limit or under-voltage sensors operate, thus 
removing DC voltage to the Control IC. 



All the secondary voltages, including the auxiliary +12 voltage, 
share the same magnetic flux linkage in the transformer core 
and are controlled by the flyback inductor. Any change in 
secondary load currents cause a change in the shared magnetic 
flux. This change in the flux of the inductor sets up an EMF 
(electromotive force) which causes a flux in opposition to the 
one which resulted from the change in load current. Thus, the 
original change tends to be counteracted and the current 
delivered to the load remains constant. 
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The output filters reduce the remaining ripple voltage com- 
ponents of the AC line and switching frequencies to levels low 
enough to prevent interference with the circuits operated by 
the supply. Switching frequency components that could be 
conducted out the AC input terminals are suppressed by the 
EMI filter to avoid interference with other equipment con- 
nected to the power line. 

The overvoltage crowbar senses an abnormal rise in the +5.1 
volt output and short-circuits the voltage line to the common 
secondary ground, thus tripping the current limiting circuit 
which finally shuts down the supply. 

The surge limiter at the AC line input prevents the input filter 
capacitor in-rush current surge from exceeding component 
ratings or unnecessarily tripping external fuses. 



Condition 2 


V1 


2.5 A 


5.0 A 


(Hard Disk use) 


V3 


0.75 A 


2.0 A* 




V4 


0.005 A 


0.10 A 



*NOTE: V2 and V3 connect in parallel to provide the V3 
output. The V3 output will support a 5.0 A peak load 
which decays to 1.0 A in approx. 8 seconds. V1 and V3 
must be within specified regulation when this surge decays 
to 4.0 A. 



Output Ripple Voltage: 

V1 (5.05 VDC) 

V2 (+12VDC) 

V3 (+12VDC) 

V4 (-12VDC) 



50mV p-p 
150mV p-p 
150mVp-p 
150mV p-p 



NOTE: Ripple is the composite 100/120 Hz ripple due to 
the line, plus the high frequency ripple due to the power 
oscillator. Common mode noise which may be observed due 
to oscilloscope connections should be ignored. 



6.3.2 Technical Specifications 

Environment 

Temperature; Operating 0° to 50° C (32° to 122° F) 

Storage -40° to 85° C (-40° to 185° F) 

Humidity; Operating 85% r.h. @ 35 C (95° F) max. 

Storage 95% r.h. @ 55 C (131° F) max. 

Input Voltage: 

90 to 135 VAC rms, 47 to 63 Hz 

Input Surge Current: 

48 amps max. 

Efficiency: 

70% min. at full load with 1 1 5 VAC rms input 

Output Voltages: 

V1, +5.05 VDC 
V2, +12 VDC CRT 
V3, +12 VDC DISK 
V4, -12 VDC 



Output Power: 






continuous 65 watts 


max. 




Output Current: 




Load 




Output 


Min. Max. 




V1 


1 .35 A 4.0 A 


Condition 1 


V2 


0.60 A 1.5 A 


(Model III use) 


V3 


0.40 A 2.1 A 




V4 


0.005 A 0.10 A 



Output Voltage Regulation: 

After initially setting V1, output voltage tolerances under 
all conditions of rated line, load, and temperature should 
remain within the following limits: 

V1 ( +5.05 VDC) +/- 3% 

V2 (+12 VDC) see*NOTE 

V3 (+12 VDC) +/-5% 

V4 (-12 VDC) +25%, -8.3% 

*NOTE: a) The initial value of V2 must not change by 
more than +/— 100mV under the following 
load conditions of V3: 

— A step increase in output current from 
0.6 A (initial condition) to 2.4 A, decaying 
within 60 msec to 2.1 A. 

— A step decrease in output current from 
2.1 A (initial condition) to 0.6 A. 

b) V2 output voltage may vary +/— 5% under 
all other conditions of rated line, load, and 
temperature as defined in the specification. 

Over- Current Protection: 

Power supply will shut down before total power exceeds 
the point where damage would result. No damage will result 
when any output is short circuited continuously with 100 
milliohms or less. 

Over-Voltage Protection: 

The +5.05 VDC circuit is protected with a "crowbar" 
circuit with a trip range of 5.8 to 6.8 VDC. 

Hold-Up Time at Continuous Max Load: 

Nominal Line 16 mSec minimum 

Low Line 10 mSec minimum 
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6.3.3 Theory of Operation 

The basic operating principles of a flyback converter and the 
necessary functional blocks to form a complete power supply 
were reviewed in the System Description section. In this part, 
the operation of each section of the circuit will be analyzed 
and later these sections will be connected to illustrate the 
signal flow in the power supply. 

AC INPUT 

A conventional bridge rectifier and a filter capacitor are 
connected directly across the AC line to provide the DC input 
voltage to the power supply. 

An EMI filter consisting of capacitors C30-C33 and choke T2 
are inserted at the input to the rectifier. This filter circuit 
keeps the high frequency signals generated in the power supply 
from being conducted into the AC power line. C30 and C31 
provide a low impedance to the earth ground terminal for 
signals common to both hot and neutral sides of the AC line. 
C32 provides a low impedance dissipative path for the RF 
signal energy which appears across the line. T2 blocks RF 
signals common to both sides of the line and reflects them 
back toward the lower impedance elements near the rectifier. 
T2 also helps block differential (across the-line) signals by 
using the EMF set up by the signal current on one side of the 
line to oppose the signal current flowing in the other side. C33 
serves as a transient bypass capacitor to protect the power 
supply from large transient voltages that appear on the AC 
power line. C33 also improves the efficiency of the RFI filter 
choke T2 by terminating the line in a low impedance to absorb 
and dissipate any remaining differential RF energy. 



R38 is a negative-temperature-coefficient-themistor which 
limits the turn-on surge current of the power supply filter 
capacitor C29. The resistance of this thermistor when "cold" 
is approximately 10 ohms. As the filter capacitor charges 
toward the peak value of the AC input voltage, it draws less 
current from the line. At the same time, the heating effect of 
the current flowing in the thermistor causes its resistance to 
decrease until it reaches its rated "hot" resistance of less than 
1 ohm. As you can see, the thermistor dissipates very little 
power when the power supply is in operation. The thermistor 
is designed to cool rapidly enough, during power loss or 
turn-off, to limit the turn-on surge after only a few seconds 
cool-down. 

The fuse, a fast acting 3.0 amp unit, is selected to ignore the 
short term turn-on surges, but open quickly in the event of an 
abnormally high current that would result from a component 
failure in the DC input supply or current limiting circuits. 



Auxiliary Power Supply 

The auxiliary power supply is operational when the main 
supply is on and not in a shut-down condition. This power 
supply consists of winding 2-3 on T1, half-wave rectifier CR4, 
and filter capacitor C14. The voltage output is approximately 
+15 volts under normal conditions but momentarily reaches 
about +31 volts during start-up. 

Kick Start Latch 

Start up of the circuit is initiated by the kick start latch. This 
latch is shown in simplified form in Figure 5a along with the 
accompanying waveforms in Figure 5b. When power is applied, 
C14 charges toward Vin = +160 volts through R26 with a time 
constant of approximately RC or 37.5 seconds. However, as 
we'll see, the kick start latch turns on in 2 or 3 seconds, the 
time required for the voltage across C14 to reach 30 + Vbe4 = 
30.7 volts. At this point Q4 turns on and develops a bias across 
R21 which turns on Q5. 



L5 
lOOuh 




3 amp 
l o———cr\p- 

90 to 135 VAC 
50/60 Hz 



E O- 



C28 



/T7 
Figure 6-7. Input AC Supply 
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(a) Latch Circuit 



(b) Waveforms 



+160V 



Vc5 V -H 




»> To Ul, Q2 



Vc5 
4 




Vstart 



^> time 



time 



tl t2t3 t4 



tl: Power applied 

t2: Latch turns ON 

t3: CI peak charge 

t4: CI voltage at loaded value 

Vin = 160 volts 



Figure 6-8. Kick-Start Latch 



Referring to Figure 6-8b, as C14 dumps its charge into C1 
beginning at time t2, the voltage across C14 starts to decrease 
toward a level that will be determined by the load composed 
of U1 and the base drive circuit. Notice that the voltage across 
C1 momentarily approaches the full 31 volts at time t3 before 
it drops down under load to about +15 volts at time t4. 

With C1 charging rapidly through the low resistance of a 
saturated Q4 via Vbe5, the reference supply inside U1 
develops its 5.0 volt output when the voltage across C1 
exceeds about 8 volts. At this point, the supply has not quite 
yet started, but U1 has a DC supply at pin 10. All that remains 
is to start up the pulse generator so that the supply operates 
and replenishes the charge in C14 on each cycle, thus 
maintaining a DC source for U1 of about +15 volts. Com- 
pletion of the start-up sequence occurs when the soft start 
circuit, described in the next section, has started the pulse 
generator. 



Control Section 

The control section consists of the control IC, the primary half 
of the feedback optocoupler U2, and the base drive circuit for 
the switching transistor. The control circuit IC has three major 
parts: an internal regulator, a pulse generator, and an error 
amplifier section. 



The internal reference is a regulated +5.0 DC voltage. This 
voltage provides the reference voltages for the comparators 
used in the pulse generator as well as the DC supply voltage for 
the feedback optical coupler and the internal circuits of U1 
except for its output transistors. 

The pulse generator section of the control IC has four major 
parts: (a) sawtooth oscillator; (b) wave-shaping and output 
circuit; (c) regulating comparator; (d) dead-time comparator. 
Figure 6 illustrates the sawtooth oscillator and output circuit 
waveforms and the approximate levels of the DC control 
voltages applied by the comparators to the wave-shaping logic. 
The oscillator frequency is set by the values of R3 and C7 
shown in Figure 7. 

The amplitude of the sawtooth is set at 3.0 volts (approx- 
imately 60% of the 5.0 volt reference voltage). Whenever the 
sawtooth voltage, Vosc, exceeds both of the DC control 
voltages, Vreg and Vdt, the output circuit will be in the ON 
condition. 

The DC control voltage, Vreg, set at a quiescent value by R6 
and R9, varies in response to changes in the supply's DC 
output voltages as sensed by U3 and coupled through U2. 
Notice that these voltages will vary because of changes in 
output loading, AC input voltage, -and also because of the 
residual 120 Hz ripple component from the main DC supply. 
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The dead-time control voltage, Vdt, is set at a constant value 
by R4 and R5 and ensures that the pulse generator "OFF" 
time will be at least 50% of the sawtooth period. This allows 
adequate time for the complete transfer of stored energy from 
the primary to the secondary of transformer T1 as discussed in 
the section on basic principles. 

A concept known as duty cycle was introduced in earlier 
paragraphs. Duty cycle is defined as the ratio of the "ON" 
time of the sawtooth cycle to the total length of the sawtooth 
period. Since the sawtooth has a linear ramp characteristic, the 
duty cycle is also equal to: 



duty cycle d = 



Vosc, pk — Vreg 
Vosc, pk 



ton 



T period 



The dead-time control voltage is used in one other important 
way. Notice the 4.7 /ifd capacitor, C2, connected across R4 in 
Figure 6-10. When power is first applied to the supply, the 
voltage across the capacitor is zero. Therefore, Vdt = Vref = 
5.0 volts and no pulses appear at the output because Vdt is 
greater than Vosc.pk. As C2 charges, Vdt decreases toward 1/2 
(Vosc,pk) in a time determined by R5 and C2 as t = 5x1 5k 
ohm X 4.7 jufd = 1/3 second. As Vdt decreases past Vosc, pk, 
very narrow pulses begin appearing at pin 8 of U1. The pulses 
become successively wider until Vdt is less than Vreg. C2 
continues charging until Vdt reaches the final correct value of 
about 1.5 volts. This action provides the soft start feature of 
the power supply and allows sufficient time for the DC input 
supply and latch to reach normal operating conditions before 
the supply is started. In effect, the load is connected to the 
supply gradually by the soft start circuit. 



There are three possible conditions of the duty cycle: 

d = which occurs when either control voltage Vreg 

or Vdt exceeds the peak value of the sawtooth 
waveform Vosc 

d = 50% which occurs when Vreg is less than Vdt. This 
happens when the loading on the output of the 
supply is heaviest and the AC input voltage is at 
its lowest permitted level (see specifications) 

(d (50% which occurs during normal operation. 



Frequency stability of the sawtooth oscillator is provided by 
the 2% tolerance and polyester construction of the timing 
capacitor, C7, and the 100 parts-per-million temperature 
stability and 1% tolerance of R3. Voltage stability of the DC 
control voltages is provided by the +/— 2 1/2 percent stability 
of the 5.0 volt reference. 

The control section consists of two error amplifiers in U1, the 
primary half of U2, and associated circuitry shown in Figure 
6-10. One of the error amplifiers serves as a regulator or pulse- 
width modulator which derives the DC control voltage, Vreg, 
from the signal voltage developed across R7 by the current 
in U2. 



Vosc, volts (Ul, pin 5) 



Vout, volts (Ul, pin 8) 



_|_ Vosc,pk 

2.5V = Vreg 

1.5V = Vdt 




^^ time 



Figure 6-9. Oscillator, Pulse Generator Waveforms 
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Figure 6-10. Control Section 



This current is a replica of the current developed by U3 in 
response to the condition of the output voltage at the +5.1 v 
and +12v outputs. This amplifier has a gain of about 10 
determined by: 



R8 



R9 



R6 



22k ohm 
2.35k ohm 
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The output transistor of U1 combined with Q3 forms a 
Darlington pair. This circuit provides the relatively large 
current necessary (through coupling capacitor C8) to turn on 
Q7. R23 limits this base current to a value large enough to 
turn on Q7 quickly, but not so large that it will exceed the 
ratings of Q3, C8, or the base emitter junction of Q7, or so 
large that the turn-off time of Q7 is excessive. 



The other error amplifier in U1 serves as a shut-down 
comparator. The positive terminal, pin 14, is set at the +5.0 
volt reference and pin 13, the negative terminal or shut-down 
pin, is tied to the current limit latch. The output of this error 
amplifier (equal to Vreg since both error amplifier outputs are 
tied to the wave-shaping logic) will rapidly increase toward the 
+5.0 volt reference when pin 13 drops below 5.0 volts. Recall 
that if Vreg exceeds the peak sawtooth voltage, pulses are 
inhibited and the power supply shuts-down. 



Base Drive 

Figure 6-1 1 illustrates the BASE DRIVE circuitry which turns 
switching transistor Q7 on and off in response to the output of 
the pulse generator portion of U1. The "ON" circuit is shown 
in Figure 6-1 1a and the "OFF" circuit is shown in Figure 
6-1 1b. Waveforms for these circuits appear in Figure 6-12. 




(a) Turn Q7 ON 



(b) Turn Q7 OFF 



Figure 6-11. Base Drive Circuit 
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Figure 6-12. Q7 Base Voltage Waveform 



As Q3 turns on, C8 charges to approximately +5 volts and Q7 
is driven into saturation. Energy is stored in the primary 
winding of T1 as the collector current of Q7 increases or 
"ramps up" at a rate determined by the inductance of the 
transformer primary winding. 

When the output transistor of U1 turns off, the emitters of Q1 
and Q2 are initially at the +6 volt level determined by the 
charge on C8, the Vbe drop of Q7, and the drop across R37. 
Both base-emitter junctions of the Q1-Q2 Darlington pair are 
biased ON and the positive terminal of C8 is clamped to 
near-ground by the saturating Q1. At this point, C8 still has 
most of its charge and the base voltage of Q7 is approximately 
—4.5 volts with respect to ground. 

With the strong reverse polarity provided by C8 across the base 
emitter junction of Q7, the "forward" charge stored in the 
junction capacitance is quickly swept out and Q7 is turned off. 
C8 continues to discharge through R24 to prepare for the next 
"ON" cycle. R19 limits the initial discharge of C8 while Q7 is 
turning off. 



Notice the symmetry in the base drive circuit and the key role 
played by C8 in both the turn-on and turn-off sequences. 
Because of this crucial role in the circuit, this capacitor is 
specified as a high temperature, low-equivalent -series-resistance 
component. 

Primary Circuit and Current Limit Shutdown 
The Primary Circuit 

The Primary circuit, shown in Figure 6-1 3a functions exactly 
as described earlier in the "Basic Principle" section. That is, 
the switch (Q7) is controlled by the base drive waveform 
developed by the control section. 

The Snubber Circuit 

Practical transformers cannot couple 100% of the stored 
energy from the primary to the secondary since all of the flux 
from the primary fails to link all the secondary turns. A circuit 
using this practical transformer behaves as though a small 
fraction of the primary inductance was not wound on the core 
of the transformer, but instead placed apart from the primary 
and in series with it. This small, separately-acting inductance 
does not participate in the transformer action and is called the 
leakage inductance. 

If the resonant circuit, consisting of this leakage inductance 
and the stray capacitance in the adjacent circuit, has sufficient 
Q (relatively low resistance losses), a damped oscillation will 
occur in this resonant circuit when the transistor switch opens. 
The peak value of this oscillation will add to the Vce = 2 x Vin 
which appears across the transistor switch just after turn-off. 



kick-start 
reset 



shut-down 
control 




Control Bus 



Detector 



(a) Primary 



(c) Current Limit Sense 



Figure 6-13. Primary Side Protection 
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The combined peak Vce may exceed the transistor breakdown 
rating if not damped out by the action of a snubber circuit. 

When Q7 turns off, the energy stored in the leakage 
inductance is transferred to the electric field of the total 
capacitance of C37 plus stray capacitance. (Since C37 
capacitance is much larger than the strays, it dominates in this 
action and tends to limit the peak value of the Q7 turn-off 
voltage.) If there were no resistance in this series connection of 
C37-plus-parasitics and leakage inductance, they would 
exchange this energy back and forth indefinitely. R40 is used 
to damp this oscillation without excessively slowing the 
turn-off of Q7, thus effectively snubbing the turn-off voltage 
spike at the collector of Q7. 



Under-Voltage Lockout 

The Under-Voltage Lockout, UVL, shuts down the supply 
whenever the AC input voltage drops below about 90 volts. 
This occurs when the voltage at pin 13, set by the divider 
action of R27 and R25, diminishes to a level below the 
internal reference supply of the control IC. Pulses are inhibited 
immediately and because the DC supply to the Control IC is 
no longer replenished by the auxiliary supply, it discharges 
toward zero. 

Why is it important to shut down the supply if the input AC 
line drops below 90 volts? The answer will become clear when 
an inherent characteristic of the circuit is discussed, namely, 
its negative input resistance. 



Current Limit Circuit and the Shut-Down Sequence 

The current limit circuit forces the voltage level at a control 
pin of U1 to change to a near-zero value very quickly when the 
current in the transistor switch exceeds a predetermined point. 
It also removes the supply voltage from the control circuit and 
resets the kick start latch and soft -start circuits. 

The current limit circuit shown in Figure 6-13c has three 
parts: a control bus, a detector, and a latch. The control bus 
supplies the operating DC voltage to the current limit circuit. 
It also conducts the current limit signal to control pin 13 and 
to the reset-point in the kick start latch circuit. Diodes CR2 
and CR3 steer this signal. 

The normal maximum peak current in switching transistor Q7 
is 3 amps. The detector transistor Q8 is biased to turn on by 
the divider action of R35 and R36 whenever the Q7 peak 
current through R37 exceeds 4 amps. A low-pass filter, formed 
by R35 and C22, prevents false detections on transient signals 
that don't represent an over-current condition. 

As soon as Q9 turns on, its collector current develops the 
turn-on bias for Q8 across R33, and the Q8-Q9 pair "latches" 
in the "ON" state until the DC source for the latch is removed. 
Removal of this DC source occurs when C1 discharges through 
CR1, thus removing DC voltage from the control IC. Notice 
also that the kick start latch, Q4 and Q5, is still in the "ON" 
state and thus provides a discharge path for C14. When the 
decreasing voltage across C14 is less than approximately one 
volt, the Q4-Q5 latch also switches off. 

At this point in time, all circuits are in an OFF condition 
except the input DC supply. C14 now begins to re-charge 
toward the input DC supply to restart the power supply. If a 
fault remains, the kick start and current limit circuits will 
continue to shut-down and re-start the power supply several 
times per second until the fault is removed or AC power to the 
supply is turned-off . 



Imagine the situation where the supply is delivering full power 
to its load and the AC input voltage drops five or ten volts. 
The supply control circuit responds by increasing the "ON" 
time of the switching transistor thus increasing the average 
current in the primary winding. The only way the DC supply 
can deliver more current is to draw it from the AC line. So the 
negative change in AC input voltage was accompanied by a 
positive change in AC input current. 

Another way to describe this characteristic is that the supply is 
a constant power device, that is: 

Pin = Vin x I in = constant. 

Thus if V decreases, I will increase, and vice versa. The supply 
will thus draw more and more current from the AC line if the 
AC voltage continues to decrease. In order to limit the average 
current to a safe value, the control circuit senses the input 
voltage and shuts down the supply before the AC voltage level 
becomes too low or the AC current input becomes too high. 



Secondary Outputs 

Each of the secondary windings consist of a half-wave rectifier 
followed by a pi filter. The input capacitor of the filter stores 
the charge delivered to it when the rectifier is biased ON by 
the polarity of the transformer winding. The inductor and the 
output capacitor form a low-pass filter which removes the 
switching frequency ripple component. 

The current output of the —12 volt supply is much smaller 
than that of the positive voltage outputs. Because of this, the 
current limit circuit response is not sufficiently effective to 
prevent damage to the -12 volt circuit. Therefore, a three 
terminal regulator with its own current limiting circuit is used 
to protect the —12 volt output. 

All of the 12 volt rectifiers are fast recovery types and the +5 
volt rectifier is a Schottky type. These diodes feature high 
switching speeds during turn-off. Their low forward voltage 
drop minimizes dissipation resulting in maximum efficiency. 
Each of the positive outputs has a bleeder resistor. 
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The reason for two separate +12 volt outputs is to provide 
sufficient isolation between different types of loads. It is easier 
to regulate the +12 volts if the load which contains the DC 
motors in the disk drives is separated from the rest of the 
loads. In addition, the +12 volt "Disk" output (V3) is included 
in the load sense network in order to minimize the load 
transients which occur when the disk drives turn on and off. 
The supply is then better able to regulate the other +12 volt 
output (V2) during the severe V3 transitions. 



transient signal occurring on the +12V CRT output (when the 
motors turn on or off) is fed to R15 by C17. The wiper of 
R15 feeds a control signal which represents the status of the 
current loads to the error amplifier U3. U3 amplifies and 
compensates it then U2 couples that control signal to U1 
where it is used to vary the switching transistor (Q7) ON time 
to adjust the output voltages as necessary. R15 is adjustable to 
provide the initial set-up of the +5.05V output when it is 
installed in a computer. 



Load Sense and Feedback Signal Development 



Overvoltage Crowbar 



The circuit of Figure 6-14 has three parts. In part (a), the IC's 
U2 and U3 are biased ON by resistors R11 and R22. These 
resistors also sense the changes in AC line input voltage to 
provide line regulation. U2A is the LED half of an optocoupler 
which serves to isolate the DC ground circuits of primary and 
secondary while coupling the AC feedback signal via optical 
coupling. U3 serves as both a stable DC reference voltage 
which the output voltages are compared against and as an error 
amplifier which provides the gain necessary for adequate 
sensitivity of the control lOto load changes. 

Each of the passive components in the load sensing network is 
a high stability (+/— 100ppm) part to assure stability of the 
network over the operating temperature range of the power 
supply. 



Some of the circuits supplied by the +5 volt output are quite 
sensitive to voltages in excess of 7 volts. Since some circuits 
require both +5 and +12 volts, a failure in those circuits could 
apply +12 volts to the +5 volt bus and thus damage some of 
the +5 volt circuits. To prevent the +5 volt bus from exceeding 
a safe level, an SCR, Q6, is used to "crowbar" or short-circuit 
the +5.05-volt output to the secondary ground bus. This short 
circuit triggers the current limiting circuit and the supply shuts 
down until it tries to restart. 

Referring to Figure 6-15, VR2 sets the turn-on point of the 
SCR and R17 develops the gate signal when VR2's Zener 
breakdown voltage of 5.6 volts is exceeded. C6 and R17 pro- 
vide current limiting for VR2 and filter the gate signal so 
Q6 won't respond to transient signals. 



Part (b) of Figure 6-14 includes the network which tailors the 
frequency response of the error amplifier so that it responds to 
low frequency change only. This network, consisting of 
R14/C5 and R13/C4, also determines the stability of the 
power supply by ensuring that the power supply control 
circuit has no tendency to oscillate. 

Part (c) illustrates the load sensing network. Equal currents 
through R15 are supplied from the +12V DISK and +5.05V 
outputs by R29 and R30. In addition, a portion of the 



Power Chain 

In a sense we have already analyzed the power chain in the 
section on basic principle of operation. The base drive causes 
the switching transistor to turn on and off at a prescribed rate. 
This action alternately stores energy from the DC input in the 
primary inductance and releases it into the secondary through 
the flyback transformer action. The energy is then stored in 
the input filter capacitor at a voltage determined by the 
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Figure 6-14. Feedback Signal Development 
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5 Volt 
Output 



Figure 6-15 Overvoltage Crowbar 

transformer turns ratio. Notice that the turns ratio determines 
the ratio of collector voltage to secondary voltage, both of 
which are alternating voltages. The ratio of input-to-output DC 
voltage is determined by the duty cycle and the turns ratio 
together. 

For example, lets look at the +5 volt output of Figure 6-16 at 
normal loading and approximately 120 VAC input. Under 
these conditions, the DC input voltage is 168 VDC and the 
duty cycle is approximately 40%. Thus, our average DC 
voltage at the switching transistor collector (or across the 
primary) is 40% of 168 or 67.5 volts. Dividing this average DC 
voltage by the turns ratio for the 5 volt secondary (54 : 4 = 
13.5) gives us 5.0 volts. 



67.5V 



_TL_r 



base drive 




O +5 VDC 



Figure 6-16. Power Chain 



Control Chain 

Imagine the load end of the feedback path disconnected from 
the +5.1 volt output terminal and unfolded so that the load 
sense network is now at the "input". The secondary rectifier 
(CR5) and filter (C10/C11, L1, C12) remain as the output. 
The circuit as it now appears, redrawn in simplified form in 
Figure 6-17 is known as the control chain. To see how the 
regulation action occurs, assume a small negative voltage 
change at the "input" of the feedback network and follow it 
through the control chain. 

This negative voltage change, which would correspond to a 
slightly heavier load current, appears at pin 1 of U3 as a 
decreasing voltage. The error amplifier in U3 inverts and 
amplifies this signal. The positive-going output voltage of U3 
at pin 3 causes less current to flow in the internal LED of 
U2A. A replica of this smaller current, optically coupled and 
induced in the phototransistor of U2B, develops a reduced 
voltage across R7 at the non-inverting input of the regulator 
error amplifier in U1. 

The regulator error amplifier in U1 does not invert the signal, 
but further amplifies it, improving the sensitivity of the 
control chain to small changes at the power supply output. 
The regulator error amplifier output is Vreg. Since we 
established earlier that a negative-going Vreg increases the' 
length of the base drive pulse, Q7 is turned on a little sooner 
so that it can store more energy from the AC line in the 
primary inductance. Finally, this increased energy is stored in 
the filter capacitor C10/C11 during the flyback interval and 
supplies the increased demand for current that resulted in the 
original reduction in the output voltage. 

More simply stated, the control chain uses an amplified version 
of the output voltage CHANGE to adjust the width of the base 
drive pulse through the action of a control voltage at a 
comparator input. 
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Figure 6-17. Control Chain Simplified Schematic 



6.3.4 Troubleshooting Chart for Power Supply #8790049, 65 Watt 



Trouble 

open fuse 



Cause 

shorted line input 
filter capacitor 

shorted bridge 

shorted filter 
capacitor 

shorted switching 
transistor 



Remedy 

check and/or replace 
C33, C32, C31,C30 

check BR1 

check C29, C26, R39 



check Q7, C37, 
R40, C26,T1 pri., 
Q3, Q1 , R37 



shorted snubber 
capacitor or 
resistor 



check C37, R40 



open opto-coupler check U2 



shorted supply 
output 



shorted output 
rectifier 



check computer for 
short on +5V,+12V 
CRT, +12V DISK, -12V 
outputs and clear 
shorted condition 

check CR5, CR6,CR7, 
CR8 



Current 
limit cycle 



single rectifier 
open in bridge 

open filter 
capacitor 



check and/or replace 
BR1 

check C29 



open or shorted 

output 

filter capacitor 

defective crowbar 



check C1 6, C18, C25, 
C23, C10, C11.C12, 
C19, C20 

check Q6 
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no pulses 
at pin 8 
of U1, 
(i.e., supply 
shut down) 



no aux. DC supply 



no "kick start" 



check and/or replace 
CR4,C14, T1 aux. 



check R26, Q4, Q5, 
VR1,CR1,C1 



3. Apply +35 volts DC through a 120K ohm resistor and a 
normally closed SPST switch to U1 pin 13. Operate the 
switch and observe Q8 base (TP1) for loss of base drive 
pulses. 



no base drive 



dead-time control 
divider malfunction 



check U 1,0.3, R23, 
C8, R24 

check C2, R4, R5, 
U1 (for V ref.) 



under-voltage protect check R27, R25, C9, 
divider malfunction Q9 



PWM feedback 
malfunction 



check and/or replace 
U1,U2,C3 



Operational, Checks T2, U1, U2 

APPLY AC POWER 

1. Apply rated maximum loading for condition 1 (Model III 
use) or condition 2 (5 1/4" Hard Disk use). 

2. Apply 120 VAC input voltage and observe Q7 current (via 
loop on PCB) and voltage (at TP2). Supply should start in 
two to four seconds. 

3. Observe the +5.05 volt output and adjust R15 until the 
output is exactly +5.05 volts DC. 

4. Measure +1 2V and -\ 2V outputs. 

5. Check all outputs at Vin = 90 VAC and 135 VAC at: 

(a) minimum and maximum loads 

(b) check +12V CRT when +12V DISK varies in transient 
test. 



6.3.5 Testing and Adjustments 

The following tests should be performed to guarantee correct 
operation of the power supply after repairs have been made. 
The first test checks the primary circuits and is to be made 
without AC power applied. The second test is a complete 
operational test with AC power applied. 



6. Measure ripple. See Measurement Techniques below. 

7. Measure efficiency. See Measurement Techniques below. 

8. Test operation of current limit and over-voltage protec- 
tion circuits by applying +7.0 volts to the +5 volt output. 



Primary, Checks T2, U1 

NO AC POWER APPLIED 

1. Apply +35 volts DC via 3900 ohm resistor from Q5 
emitter to primary side ground. Observe the voltage across 
C5 as it charges. As it reaches a value near +31 volts 
(about 2 seconds), it should drop to near +15 volts as Q5 
turns on. 



Measurement Techniques 

1. Ripple — Unit connected to full load at low line. One end 
of 50 ohm coaxial cable connected to output terminals. 
Other end of cable (terminated with 0.01 uF ceramic cap 
in series with 51 ohm resistor) connected to scope using 
BNC T -fitting. Two components at 120 Hz and 40 kHz. 

2. Efficiency — Use Diego Systems Series 200 power 
monitor. Efficiency = Power Out 

Power In 



Check U1 pin 8 and/or Q8 base for a base drive pulse: a 
40 kHz square wave of 8 volts/4 volts amplitude respec- 
tively. 
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Parts List, Power Supply #8790049 (Tandy 65W) 



Item Sym Description 



Mfgr's Part No, 



Capacitor , 
Capacitor , 
Capacitor , 



10 ufd, 35V Elect Radial 

4.7 ufd, 25V Elect Radial 

0.047 ufd, 50/63V 
Capacitor, 0.47 ufd, 50/63V 
Capacitor, 0.068 ufd, 50/63V 
Capacitor, 1 ufd, 50V, Elect Radial 
Capacitor, 0.001 ufd, 63V 
Capacitor, 47 ufd, 25V, Elect Radial 
Capacitor, 1 ufd, 50V, Elect Radial 
Capacitor, 2200 ufd, 10V, Elect Radial 
Capacitor, 2200 ufd, 10V, Elect Radial- 
Capacitor, 2200 ufd, 6.3V, Elect Radial 
Capacitor, 0.01 ufd, 50/63V 
Capacitor, 100 ufd, 35V, Elect Radial 
Capacitor, 1000 pf d , 100V, Ceramic Disk 
Capacitor, 2200 ufd, 16V, Elect Radial 

0.1 ufd, 50/63V 

3300 ufd, 16V, Elect Radial 

100 ufd, 25V, Elect Radial 
Capacitor, 100 ufd, 25V, Elect Radial 
Capacitor, 0.01 ufd, 50/63V 
Capacitor, 0.01 ufd, 50/63V 

470 ufd, 16V, Elect Radial 

0.1 ufd, 250V 
Capacitor, 2200 ufd, 16V, Elect Radial 
Capacitor, 220 ufd, 200V, Elect Radial 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 

12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 



CI 

C2 

C3 

C4 

C5 

C6 

C7 

C8 

C9 

C10 

Cll 

C12 

C13 

C14 

C15 

C16 

C17 

C18 

C19 

C20 

C21 

C22 

C23 

C24 

C25 

C26 

C27 

C28 

C29 

C30 

C31 

C32 

CRl 

CR2 

CR3 

CR4 

CR5 

CR6 

CR7 

CR8 

JBRX 

VRl 

VR2 

VR3 



Capacitor , 
Capacitor , 
Capacitor, 



Capacitor, 
Capacitor, 



Not Used 
Capacitor , 
Capacitor, 



0.01 ufd, 25 VAC 

220 ufd, 200V, Elect Radial 

Capacitor, 4700 pfd, 125VAC, Ceramic Disk 

Capacitor, 4700 pfd, 125VAC, Ceramic Disk 

Capacitor, 0.1 ufd, 250VAC 

Diode, 1N4148, Switching 

Diode, 1N4001, 1A/50PIV 

Diode, 1N4001, 1A/50PIC 

Diode, 1N4939, 1A/100PIC 

Diode, MBR1035, 8/10A, 35V, TO-220 

Diode, MUR810, 8A/100PIV, TO-220 

Diode, 1N4934, 1A/100PIV 

Diode, MUR810, 8A/100PIV, TO-220 

Dioide Bridge, 2A,600PIV 

Zener Diode, 1N5232B, 5.6V 

Zener Diode, 1N5256B, 30V 

Diode, A79M12 



8326103 
8325470 
8393474 
8394474 
8393684 
8325014 
8392104 
8326472 
8325014 



8328220 
8393104 
8327103 
8302106 
8328221 
8304104 
8328331 
8327102 
8327102 
8393104 
8393104 
8327461 

8328221 
8327226 

8393106 
8327226 
8303475 
8303475 
8394106 
8150148 
8150001 
8150001 
8150934 
8150035 
8150810 
8150934 
8150810 
8160402 
8150232 
8150256 
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Parts List, Power Supply #8790049 (Tandy 65W) 

Item Sym Description Mfgr's Part No, 

45 Fl Fuse, 3A, AGC 8479104 

46 Ll Inductor, 5.0h,m 10A 8419006 

47 L2 Inductor, 30h, 5A 8419008 

48 L3 Not Used 

49 L4 Inductor, 30h, 5A 8419008 

50 L5 Inductor, lOOh, 2A 8419009 

51 Ul IC, MC34060, Switching Regulator 8060060 

52 UA/TL494 Switching Regulator 8060494 

53 U2 IC, 4N35, Opto-Isolator 8170428 

54 Rl Resistor, 1 kohm, 1/4W 5% 8207210 

55 R2 Resistor, 68 ohm, 1/4W 5% 8207068 

56 R3 Resistor, 28 kohm, 1/4W 1% 8200328 

57 R4 Resistor, 39 kohm, 1/4W 5% 8207339 

58 R5 Resistor, 15 kohm, 1/4W 5% 8207315 

59 R6 Resistor, 4.7 kohm, 1/4W 5% 8207247 

60 R7 Resistor, 4.7 kohm, 1/4W 5% 8207247 

61 R8 Resistor, 22 kohm, 1/4W 5% 8207322 

62 R9 Resistor, 4.7 kohm, 1/4W 5% 8207247 

63 R10 Resistor, 4.7 kohm, 1/4W 5% 8207247 

64 Rll Resistor, 100 ohm, 1/4W 5% 8207110 

65 R12 Resistor, 620 ohm, 1/4W 5% 

66 R13 Resistor, 18 kohm, 1/4Q 5% 8207318 

67 R14 Resistor, 330 ohm, 1/4W 5% 8207133 

68 R15 Potentiometer, 1 kohm, 20%, Linear 8275211 

69 R16 Resistor, 3.31 kohm, 1/4W 1% 8200232 

70 R17 Resistor, 100 ohm, 1/4W 5% 8207110 

71 R18 Resistor, 10 ohm, 1/4W 5% 8207010 

72 R19 Resistor, 1 ohm, 1/4W 5% 8207001 

73 R20 Resistor, 4.7 kohm, 1/4W 5% 8207247 

74 R21 Resistor, 220 ohm, 1/4W 5% 8207122 

75 R22 Resistor, 330 ohm, 1/4W 5% 8207133 

76 R23 Resistor, 27 ohm, 2W 10% 8248127 

77 R24 Resistor, 22 ohm, 1/2W 5% 8217022 

78 R25 Resistor, 22 kohm, 1/4W 5% 8207322 

79 R26 Resistor, 75 kohm, 1W 10% 8248127 

80 R27 Resistor, 430 kohm, 1/4W 5% 8207443 

81 R28 Resistor, 22 ohm, 1/4W 5% 8207022 

82 R29 Resistor, 28 kohm, 1/4W 1% 8200328 

83 R30 Resistor, 6.65 kohm, 1/4W 1% 8200266 

84 R31 Resistor, 1 kohm, 1/4W 5% 8207210 

85 R32 Resistor,' 1 kohm, 1/4W 5% 8207210 

86 R33 Resistor, 470 ohm, 1/4W 5% 8207470 

87 R34 Resistor, 1 kohm, 1/4W 5% 8207210 

88 R35 Resistor, 470 ohm, 1/4W 5% 8207470 
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Parts List, Power Supply #8790049 (Tandy 65W) 

Item Sym Description Mfgr's Part No, 

Resistor, 1 kohm, 1/4W 5% 8207210 

Resistor, 0.22 ohm, 2W 10% 8248022 

Thermistor 8298016 

Resistor, 75 kohm, 1W 10% 8248375 

Resistor, 82 kohm, 5W 10% 8248268 

Transistor, MPSU51A, PNP, TO-202 8100051 

Transistor, MPSA55, PNP, TO-92 8100055 

Transistor, MPSU01A, NPN, TO-202 8111001 

Transistor, MPSU51A,PNP, TO-202 8100051 

Transistor, MPSU01A, NPN, TO-202 8111001 

SCR, 8A/50PIV, TO-220 8140122 

Transistor, MJE13006, NPN, 8A, 400V 8110006 

Transistor, MPSA55, PNP, TO-92 8100055 

Transistor, MPSA05, NPN, TO-92 8110005 

Transformer, Power, Ferrite Core 8790046 
Transformer, Line Choke, 5.5 mH/side, 2A 8790045 
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VIDEO MONITOR 



7.1 VIDEO MONITOR #8492002 (RCA VERSION) 
7.1.1 Functional Specifications 

The video monitor is a 12-inch solid state monitor designed 
for display of alphanumeric dot characters. The monitor is 
designed for a 12-volt DC power input with an average 
power consumption of 12 watts. The monitor accepts sep- 
arate video, and vertical drive TTL level inputs. 

SPECIFICATIONS 



Cathode Ray Tube: 



Environment: 



Power Input: 

TTL Level 
Input Signals: 



Video Response: 

Scanning Frequency: 

Horizontal Retrace: 
Vertical Retrace: 



12" diagonal, 90° deflection angle, 4x5 aspect ratio, P4 phosphor, 
integral implosion protection. 

Operating Temperature: 41°F to 131°F (5°C to 55°C) ambient 
Humidity: 95% non-condensing at 41°F to 104°F (5°C to 40°C) 
Operating Altitude: 10,000 ft. (3046 meters) maximum 

+12 VDC at 1 amp nominal 

4 volts ± 1 .5 volts 

Horizontal : 4 to 25/zsec, positive going 
Vertical: 100 to 1400jusec, negative going 
Video: positive white 

Bandwidth: 15 MHz, 3 dB 
Pulse rise time less than 30nsec 

Horizontal: 15,600 Hz ± 500 Hz 
Vertical: 50/60 Hz 

10.5//sec maximum 

850/isec maximum 
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7.1,2 Service Adjustments 



WIDTH 



SMOTE: Measurements should be madeusing 12.0 VDC input. 
Measurements with kine (CRT) attached will require the 
ground strap from kine be connected to chassis to prevent 
transistor failures in the event of kine arcing. 

FOCUS 

Adjust focus control F524 for best overall focus. 

VERTICAL SIZE 

Adjust vertical size control R617 to produce vertical scan 
of approximately 6 inches. 



Note: Check horizontal linearity prior to width adjustment. 
Adjust width control to produce horizontal scan of approx- 
imately 8 inches. 

CENTERING 

Adjust centering rings on deflection yoke assembly to center 
display on screen top to bottom and left to right. 

HORIZONTAL HOLD 

Horizontal Hold is accomplished by adjustment of the 
horizontal oscillator coil. 



HORIZONTAL LINEARITY 

Loosen deflection yoke clamp and slide linearity sleeve for- 
ward or backward to equalize character spacing on left side 
to match character spacing on right side of screen (See 
Figure 7-1 for location of linearity sleeve.) 



KINE 




ENTERING 

MAGNETS 



iNEARiTY 

SLEEVE 



FIGURE 7-1. DEFLECTION YOKE ASSEMBLY 
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COMPONENT LAYOUT/CIRCUIT TRACE, VIDEO MONITOR PCB #8492002 (RCA) 
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Video Monitor Assembly #8492002 (RCA #KTRl3lB & C) 

Item Qty Description Mf gr ! s Part No, 



Kine Socket Assembly 

Ferrite (FB501-506,601) 
Bead Choke Assembly (L502) 

(Peaking) 39uH (L301) 
(Peaking) 22uH (L302) 
Horiz. Hold (L501) 
(L504) 

.1 ufd 100V 10% Polyester (C301) 

680 pfd 50V 10% Cer (C302) 

.01 ufd 1000V 20% Cer (C303 , 513 , 527 ) 

2700 pfd 50V 10% Cer (C501) 

1000 pfd 50V 20% Cer (C502 , 512 ,603 ) 

.033 ufd 100V 10% Polyester (C503 , 507 , 604 ) 

.018 ufd 200V 10% Polyester (C504) 

5.6 ufd 20V +100-10% Elec (C506) 
.015 ufd 100V 10% Polyester (C508) 
.022 ufd 200V 10% Polyester (C509) 
.01 ufd 200V 10% Polyester (C510) 
.47 ufd 200V 10% Polyester (C511) 
470 pfd 1000V 10% Cer (C514,516) 
180 pfd 10% 1000V Cer (C515) 
1 ufd 150V Elec (C517) 
10 ufd 150V Elec (C518) 
1 ufd 350V Elec (C519) 
390 pfd 500V 10% Cer (C520) 
56 ufd 50V +100-10% 50V Elec (C521) 
1000 pfd 500V 10% Cer (C522,525) 
470 ufd 25V +100-10% Elec (C523) 
330 ufd 25V +100-10% Elec (C524) 

4.7 ufd 50V +100-10% Elec (C528) 
.0039 ufd 5600 250V Cer (C529) 
220 ufd 15V +100-10% Elec (C605,606) 
5600 pfd 200V 10% Polyester (C607) 
47 ufd 6V +100-10% Elec (C608) 
.1 ufd 100V 10% Polyester (C609) 
.68 ufd 80V 20% Elec (C610) 
3300 pfd 500V 10% Cer (C611) 
270 pfd 50V 10% Cer (C702) 



1 


1 


Board 


2 


1 


Kine 


3 


7 


Bead, 


4 


1 


Bead 


5 


1 


Coil, 


6 


1 


Coil, 


7 


1 


Coil, 


8 


1 


Coil, 


9 


1 


Cap, 


10 


1 


Cap, 


11 


3 


Cap, 


12 


1 


Cap, 


13 


3 


Cap, 


14 


3 


Cap, 


15 


1 


Cap, 


16 


1 


Cap, 


17 


1 


Cap, 


18 


1 


Cap, 


19 


1 


Cap, 


20 


1 


Cap, 


21 


2 


Cap, 


22 


1 


Cap, 


23 


1 


Cap, 


24 


1 


Cap, 


25 


1 


Cap, 


26 


1 


Cap, 


27 


1 


Cap, 


28 


1 


Cap, 


29 


1 


Cap, 


30 


1 


Cap, 


31 


1 


Cap, 


32 


1 


Cap, 


33 


2 


Cap, 


34 


1 


Cap, 


35 


1 


Cap, 


36 


1 


Cap, 


37 


1 


Cap, 


38 


1 


Cap, 


39 


1 


Cap, 
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Video Monitor Assembly #8492002 (RCA #KTRl3lB & C) 



Item Qty Description 



Mfgr's Part No, 



40 


2 


Diode (CR501,502) 


41 


3 


Diode (CR504-506) 


42 


4 


Diode (CR607-610) 


43 


2 


Res, 


100K ohm 1/4W 5% (R301,619) 


44 


1 


Res, 


220K ohm 1/4W 5% (R302) 


45 


1 


Res, 


2.2K ohm 3W 5% Fixed Metal Film PRF ( 


46 


1 


Res, 


68 ohm 1/4W 5% (R305) 


47 


1 


Res, 


680 ohm 1/4W 5% (R306) 


48 


1 


Res, 


47 ohm 1/4W 5% (R307) 


49 


1 


Res , 


270 ohm 1/4W 5% (R308) 


50 


1 


Res , 


1500 ohm 1/4W 5% (R501) 


51 


1 


Res , 


4700 ohm 1/4W 5% (R502) 


52 


1 


Res, 


12K ohm 1/4W 5% (R503) 


53 


1 


Res , 


56K ohm 1/4W 5% (R504) 


54 


2 


Res 


, 10K ohm 1/4W 5% (R506,615) 


55 


1 


Res, 


1500 ohm 1/4W 5% (R507) 


56 


1 


Res 


2200 ohm 1/4W 5% (R508) 


57 


1 


Res, 


560 ohm 1/4W 5% (R509) 


58 


1 


Res 


, 47K ohm 1/4W 5% (R510) 


59 


2 


Res 


, 330 ohm 1/4W 5% (R511,513) 


60 


1 


Res 


, 33 ohm 1/4W 5% (R512) 


61 


1 


Res 


, 470 ohm 1/4W 5% (R514) 


62 


1 


Res 


, 1.0M ohm lw 5% (R516) 


63 


1 


Res 


, 470 ohm 1/2W 5% (R517) 


64 


1 


Res 


, 470K ohm 1/2W 5% (R518) 


65 


1 


Res 


, 3.3 ohm 1/2W 5% Flameproof (R519) 


66 


2 


Res 


, 10 ohm 1/2W 5% Flameproof (R520,R527) 


67 


1 


Res 


, 6.8 ohm 1/2W 5% Flameproof (R522) 


68 


1 


Res 


, 1.0M ohm 1/4W 5% (R523) 


69 


1 


Res 


, 2.5M ohm Focus Cont. Variable (R52 4) 


70 


1 


Res 


, 1500 ohm lw 5% (R525) 


71 


1 


Res 


, 2.0 ohm 2W 5% (R526) 


72 


1 


Res 


f 1.5K ohm 1/4W 5% (R601) 


73 


1 


Res 


r 470 ohm 1/4W 5% (R602) 


74 


1 


Res 


, 15K ohm 1/4W 5% (R603) 


75 


2 


Res 


r 3900 ohm 1/4W 5% (R604,704) 


76 


1 


Res 


, 270K ohm 1/4W 5% (R606) 


77 


1 


Res 


r 220K ohm 1/4W 5% (R607) 


78 


1 


Res 


r 82K ohm 1/4W 5% (R608) 


79 


1 


Res 


r 33 ohm 1/2W 5% Flameproof (R609) 


80 


1 


Res 


r 6800 ohm 1/4W 5% (R610) 



(R303) 
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Video Monitor Assembly #8492002 (RCA #KTRl3lB & C) 



Item Qty Description 



Mfgr's Part No, 



81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 
94 
95 

96 
97 

98 

99 

100 

101 

102 

103 

104 

105 

106 

107 

108 

109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 



1 
1 
2 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 

1 

1 

1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 

2 
3 
1 
2 

1 
1 
1 
1 

1 
1 
1 
1 
2 



Res , 
Res , 
Res , 
Res , 
Res, 
Res, 
Res , 
Res , 
Res, 
Res , 
Res , 
Res , 
Res , 
Res , 
Res , 



82K ohm 1/4W 5% (R611) 
200K ohm Vert. Hold Variable 
3.9M ohm 1/4W 5% (R613,616) 
15K ohm 1/4W 5% (R614) 
750K ohm Variable (R617) 
820K ohm 1/4W 5% (R618) 
150 ohm 1/4W 5% (R621) 
120 ohm 1/4W 5% (R622) 
16K ohm 1/2W 5% (R624) 
180K ohm 1/4W 5% (R625) 
1.0M ohm 1/2W 5% (R626) 
5.6 ohm 1/2W 5% (R627) 
220 ohm 1/4W 5% (R629) 
1.5M ohm 1/4W 10% (R703 ) 
33K ohm 1/4W 5% (R705) 



(R612) 



Transformer, Horiz drive (T502) 
Transformer Rectifier Assy ( ) 



Trans is 
Trans is 
Transis 
Transis 
Transis 
Transis 
Transis 
Transis 
Transis 
Transis 
Transis 



tor, 
tor, 
tor, 
tor, 
tor , 
tor, 
tor, 
tor, 
tor, 
tor, 
tor, 



Buss 
Buss 
Buss 
Buss 
Wire 
Buss 
Wire 
Wire 
Buss 
Wire 
Wire 
Wire 
Wire 



Wire ( . 

Wire ( . 

Wire ( . 

Wire ( . 
, Electr 

Wire ( . 
, Electr 
, Electr 

Wire ( . 
, Electr 
, Electr 
, Electr 
, Electr 



7362' 

7346- 

7346- 

7335- 

7306- 

1112- 

1112- 

7318- 

7349 

7303- 

7306- 

025 x 
025 x 
025 x 
025 x 
ical 
025 x 
ical 
ical 
025 x 
ical 
ical 
ical 
ical 



-3, Video Out (Q302) 

•3, Horiz Osc (Q501) 

■3, Horiz Driver (Q502) 

-1, Horiz Out (Q503) 

-8, Vert Int (Q601) 

■8, Vert Osc (Q602) 

■8, Pre Amp (Q603) 

-2, Vert Driver (Q604) 

■2, NPN Vert Out (Q606) 

■1, PNP Vert Out (Q607) 

■7, Horiz Sep (Q701) 



1.00) (JW1,7) 

.800) (JW,2,3,5) 

1.200) (JW4) 

.900) (JW6,9) 
Hook-up (RED) 7"LG ( JW8 ) 

1.100) (JW10) 
Hook-up (BLK) 1.65LG (JWll) 
Hook-up (BRN) 5"LG (JW12) 

1.000) (JW13) 
Hook-up (BLK) 2.75LG (JW14) 
Hook-up (BLK) 3.00LG (JW15) 
Hook-up (BLK) 4.50LG ( JW16 ) 
Hook-up (BLK) 1.87LG ( ,_ 
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Video Monitor Assembly #8492002 (RCA #KTRl3lB & C) 

Item Qty Description Mf gr ' s Part No. 



Miscellaneous 

122 1 Cable Assy (BRN) 

123 1 Cable Assy (GRN) 

124 1 Cable Assy (RED) 

125 1 Cable Assy (YEL) 

126 3 Eyelet - Rolled Flange 

127 1 Fuse, 2 Ampere (F101) 
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Video Monitor Assembly #87 90607 (TCE) 



Item Qty Description 



Mfgr's Part No, 



1 
2 

3 
4 
5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

48 

19 

20 

21 

22 

23 

24 

25 

26 

27 

28 
29 

30 
31 
32 
33 
34 
35 



1 
3 

1 
2 
3 

1 
2 



2 

1 
1 
1 
1 
1 
2 
1 
1 
1 
1 
1 
1 
2 
1 
1 
3 

1 
1 

1 
1 

2 
2 
3 

1 
4 
1 



Deflection PCB unit 

w/o Trans Flyback, Heat Sink and Fuse 
390 pfd 50V 10% Cer (C101) 



Cap 
Cap 

Cap 
Cap 
Cap 

Cap 
Cap 

Cap 

Cap 
Cap 
Cap 
Cap 
Cap 
Cap 
Cap 
Cap 
Cap 
Cap 
Cap 
Cap 
Cap 
Cap 
Cap 
Cap 
Cap 

Cap 
Cap 



0.1 ufd 50V 10% Mylar (C102,305, 

308) 

22 ufd 100V 20% Elec (C103) 

0.022 ufd 50V 10% Mylar (C201,202 

0.01 ufd 50V 10% Mylar (C203,303 

307) 

0.33 ufd 50V 10% Elec (C204) 

4.7 ufd 50V 20% Elec (C205,206) 

- used up to 3000 unit - 

4.7 ufd 35V 20% Tant (C205,206) 

- from 3001 unit- 

33 ufd 16V 20% Elec (C207,208) 

1000 ufd 16V 20% Elec (C209) 

0.033 ufd 50V 10% Mylar (C210) 

220 ufd 16V 20% Elec (C211) 

100 ufd 16V 20% Elec (C212) 

470 pfd 50V 10% Cer (C301) 

1000 pfd 50V 2% Polyst (C302,306) 

0.001 ufd 50V 10% Mylar (C304) 

0.68 ufd 100V 10% Met Plas (C309) 

0.033 ufd 400V 5% Poly (C311) 

470 ufd 35V 20% Elec (C312) 

0.047 ufd 400V 10% Poly (C313) 

1 ufd 250V 20% Elec (C314) 

0.01 ufd 630V 10% Poly (C315,316) 

2200 pfd 1000V +100-0% Cer (C317) 

4700 pfd 1000V +100-0% Cer (C318) 

2200 pfd 500V +100-0% Cer (C319, 

320,322) 

15 ufd 25V 20% Elec (C321) 

220 ufd 16V 20% Elec (C401) 



Coil, Linearity (L301) 
Coil, Width (L302) 



Diode, 
Diode, 
Diode, 
Diode, 
Diode, 



1N4002 
VD1221 
1N4148 
RGP250 
1N4936 



(D101,201) 

(D202,203) 

(D301,302,304 

(D303) 

(D306-309) 



Diode, MR818 (D310) 



U-30001 


CC45SL1H391KY 


CQ92M1H104K 


CE04C226M 


) CQ92M1H223K 


CQ92M1H103K 


CE04(RB)334K 


CE04(RB)475M 


CS15E475M 


CE04C336M 


CE04C108M 


CQ92M1H333K 


CE04C227M 


CE04C107M 


CC45SL1H471KY 


CQ09S1H102G 


CQ92M1H102K 


CF92N2A 684K 


CQ92P2G 333J 


CE04C477M 


CQ92P2G 473K 


CE04C105M 


CQ92P2J 103K 


CK45E3A222PY 


CK45E3A472PY 


CK45E2H222PY 


CE04(RP)159M 


CE04C228M 


143410020A 


143310140A 


101-E 


VD1221 


1N4148 


RGP25D 


1N4936 


MR818 
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Video Monitor Assembly #8790607 (TCE) 



Item Qty Description 



36 
37 

38 
39 
40 
4.1 
42 
43 
44 
45 

46 
47 
48 
49 
50 

51 
52 
53 

54 
55 
56 

57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 

70 
71 
72 
73 
74 



1 
2 

1 
2 
1 
1 
1 
2 
1 
3 

2 
2 
1 
1 
3 

1 
2 

1 

1 
1 
3 

1 
1 
1 

1 
1 
1 
1 
1 
1 
1 
1 
2 
1 

1 
1 
1 
1 
1 



IC, AN5763 V-Process (IC201) 
IC, NE555P Timer <IC301,302) 



Res , 
Res , 
Res , 
Res , 
Res , 
Res , 
Res , 
Res , 

Res , 
Res , 
Res , 
Res , 
Res , 

Res, 
Res , 
Res, 

Res , 
Res, 
Res , 

x\GS f 

Res , 
Res , 
Res , 
Res, 
Res , 
Res, 
Res , 
Res , 
Res , 
Res , 
Res , 
Res , 



(203,309) 
(R204,212) 
(R205) 
(R206) 



220 ohm 1/4W 5% Car (R101) 
47 ohm 1/4W 5% Car (Rl02,312) 
18 ohm 1/4W 5% Car (R103) 
33 ohm 1/4W 5% Car (R104) 
47K ohm 1/4W 5% Car (R105) 
IK ohm 1/4W 5% Car (R106,107) 
820 ohm 5W 5% Cement (R108) 
4.7K ohm 1/4W 5% Car (R201,202 
207) 

100 ohm 1/4W 5% Car 
56K ohm 1/4W 5% Car 
6.8 ohm 1/4W 5% Car 
1.2 ohm 1/2W 5% Car 
220K ohm 1/4W 5% Car (208,314 
319) 

8.2 ohm 1/4W 5% Car (R210) 
10K ohm 1/4W 5% Car (R211,302) 
68K ohm 1/4W 5% Car (R212) 
- Used from 3001 unit - 
1 ohm 1/2W 5% Car (R213) 
6.8K ohm 1/4W 5% Car (R301) 
5„6K ohm 1/4W 5% Car (R303,305 
310) 

560 ohm 1/4W 5% Car (R304) 
33K ohm 1/2W 2% Car (R306) 
6.2K ohm 1/2W 2% Car (R307) 
39K ohm 1/4W 5% Car (R308) 
100 ohm 1/2W 5% Car (R311) 
56 ohm 2W 5% Metal Oxide (R313) 
82K ohm 1/2W 5% Car (R315 ) 
150K ohm 1/2W 5% Car (R316) 
220K ohm 1/2W 5% Car (R317) 
1M ohm 1/4W 5% Car (R318) 
2.7M ohm 1/2W 5% Car (R320) 
150 ohm 1/4W 5% Car (R321,322) 
100K ohm 1/4W 5% Car (R323) 



Transistor, NPN (TR101) 

Transistor, NPN (TR102) 

Transistor, NPN (TR301) 

Transistor, PNP (TR302) 



Mfgr's Part No. 

AN5763 
NE555P 

RD1/4MZ(S)221J 

RD1/4MZ(S)470J 

RD1/4MZ(S)180J 

RD1/4MZ(S)330J 

RD1/4MZ(S)473J 

RD1/4MZ(S)102J 

RT5P 821J 

RD1/4MZ(S)472J 

RD1/4MZ(S)101J 
RD1/4MZ(S)563J 
RDl/4MZ(S)6R8J 
RD1/2MZ(S)1R2J 
RD1/4MZ(S)224J 

RD1/4MZ(S)8R2J 

RD1/4MZ(S)103JZ 

RD1/4MZ(S)683J 

RD1/2MZ(S)1R0J 
RD1/4MZ(S)682J 
RD1/4MZ(S)562J 



RD1/4MZ(S 
RDl/2MZ(S 
RDl/2MZ(S 
RD1/4MZ(S 
RD1/2MZ(S 
RSM2P560J 
RD1/2MZ(S 
RD1/2MZ(S 
RD1/2MZ(S 
RD1/4MZ(S 
RD1/2MZ(S 
RD1/4MZ(S 
RD1/4MZ(S 



)561J 
)333G 
)622G 
)393J 
)101J 

)823J 

)154J 
)224J 
)105J 
)275J 
)151J 
)104J 



Transistor , 



(TR303) 



2SC1313(G) 

2SC2228Y(E) 

2SC536(F) 

2SA733(P) 

BU806 
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Video Monitor Assembly #8790607 (TCE) 



Item Qty Description 



75 
76 
77 
78 
79 



2 

1 
1 
1 
1 



Variable 
Variable 
Variable 
Variable 
Variable 



Res, 

JKSS g 

Res, 
Res, 
Res, 



100K ohm (VR201,203) 
10K ohm (VR202) 
200K ohm (VR203) 
2M ohm (VR302) 
500K ohm (VR303) 



Mfgr's Part No, 

176910250A 
176910220A 
176910260A 
176910400A 
176910270A 



Miscellaneous 



80 2 Clip, Fuse 

81 1 Connector 4 Pin 



197303080A 
194110780A 



End of Deflection Unit 



82 


1 


83 


1 


84 


1 


85 


2 


86 


2 


87 


1 



Cap, 1000 pfd 1000V +100-0% Cer (C501) 

Cathode Ray Tube (VT501) 

Fuse, 2A @ 250V (FU401) 

Res, 470 ohm 1/2W 10% (R502,503) 

Res, 100K ohm 1/2W 10% (R504,505) 

Transformer, Flyback (T301) 



CK45E3A102PY 

559010020A 

251000790A 

RC1/2GF471K 

RC1/2GF104K 

10801001YA 



Miscellaneous 



88 


1 


89 


1 


90 


1 


91 


1 



Socket, Cylindrical 
Socket, 4 Pin 

Spring Tension, Wire Ground 
Wire, Ground Terminal 



196310010A 
194010370A 
434010020A 
3160100608 
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SECTION VIII 



ILLUSTRATED PARTS CATALO' 
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Parts List, Model 4 Computer, #26-1067/8/9 



Item Qty Description 



Mfgr's PN RS Part No 



26 


1 


27 


6 


28 


4 


29 


4 


30 


2 


31 


8 


32 


1 



AXX5019 



ART3082 



Case Top 8719104 

Base 8719265 

Feet, Case 8590098 

Keyboard 8790524 

Keyboard Bezel 8719164 
Bracket, Disk Mounting (LH) 8719106 
Bracket, Disk Mounting (RH) 8719105 

Shield, Disk (RH side) 8729093 
Power Supply Assy. (on 26-1067) 8790021 

(on 26-1068/1069) 8790043 or 

8790049 

Toroid 8419030 

Bracket, Connector 8729039 

Cord, Power 8709412 

Chassis 8858073 

Main Logic PCB Assembly 6700104 

(on 26-1067) 

(on 26-1068/1069) 8858090 

Shield, Chassis 8729049 

Shield, Disk (LH side) 8729041 

Cable Assembly, Cassette 8709372 

Cable, Flat 8709381 

Video Display, CRT (RCA) 8492002 AXX8010 

Video Display, CRT (TCE) 8790607 

Bracket, Pot Mounting 8729155 

Pot, 500 ohms (Contrast) 

(part of Item 36) 
Pot, 500K ohms (Brightness) 

(part of Item 36 ) 

Knob, Thumbwheel 8719112 AK4298 

Sound PCB Assembly 8858121 

(26-1068/1069 only) 

Label, RAM size (16K) 8789261 AHC0321 

(64K) 8789800 

Name Plate 8719266 

Screw, #6 x 3/8" 8569047 

Nut, #10-24 Hex 8579021 

Washer, #8 Flat 8589016 

Screw, #6 x 3/8" 8569047 

Screw, #6-32 x 1/2" 8569046 

Cable, Keyboard Ground 8709275 



1 

2 

3 

4 

5 

6* 

7* 

8* 

9 



10 
11 
12 
13 
14 



15 

16* 

17 

18 

19 

20 
21 

22 

23 
24* 

25 



1 
1 
4 
1 
1 
1 
1 
1 
1 



1 
1 
1 
1 
1 



1 

1 
1 
1 

1 

1 
1 



2 

1 



*Not used on Model #26-1067 
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Parts List, Model 4 Computer, #26-1067/8/9 



Description Mfgr's PN RS Part No 

Cable, Ground 8709193 

Ground, Main 8709161 

Clip, Tinnerman 8559031 

Cable Assembly, CRT 8709369 
for Models 26-1068/1069 

for Model 26-1067 8709286 

Clip, Tinnerman 

Bracket, Support 8729055 

Strain Relief, Power Cord 8559014 

FDC PCB Assembly 8858060 

or 8858160 

Flat Cable Assembly 8459020 

Cable Assembly, Disk Drive 8709154 

Shield, CRT PCB Assembly 8539014 

Tab, Grounding 8529020 

Shield, Disk Drive Top 8729175 

(used on 26-1069 only) 

Shield, Mylar 8539015 

Cable Assembly, DC Power 8709367 

for 26-1068/9 

for 26-1067 8709178 

Screw, #8-32 x 3/4" PPH Blk 8569047 

Screw, #6-32 x 1/2" PPH 8569046 

Screw, #6 x 1/4" Plastite 8569077 

Screw, #8-32 x 1/2" 8569140 

Screw, #6-32 x 1/4" 8569098 

Screw, #6 x 3/8" Washer 8569128 

Screw, Chassis Mounting 8569077 

Screw, #8 x 1" 8569095 

Screw, #8-32 x 1" 8569084 

Screw, #6 x 3/8" 8569047 

Disk Drive Assembly 8790112 

Screw, #6-32 x 1/4" 8569098 

Washer, #6 Internal Star 8589043 

Nut, #6 Hex 8579014 

Standoff, Power Supply 8589079 

Switch, DPST (ON-OFF) 8489030 



Item 


Qty 


=== = : 


===.== 


33 


1 


34 


1 


35 


1 


36 


1 


37 


5 


38 


1 


39 


1 


40* 


1 


41* 


1 


42* 


1 


43 


1 


44 


2 


45 


1 


46 


1 


47 


1 


48 


3 


49 


8 


50 


4 


51 


6 


52 


4 


53* 


12 


54 


4 


55 


5 


56 


2 


57 


2 


58* 


2** 


59 


2 


60 


1 


61 


2 


62* 


3 


63 


1 



* Not Used On 26-1067 Computer 
** Qty Of 1 On 26-1068 Computer 
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SECTION IX 



RS-232C CIRCUIT BOARD 
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RS-232C CIRCUIT BOARD 



9.1 RS-232C TECHNICAL DESCRIPTION 

The RS-232C option board for the Model 4 computer 
supports asynchronous serial transmissions and conforms 
to the EIA RS-232C standards at the input - output 
interface (P1). The heart of the board is the TR1602 
Asynchronous Receiver/Transmitter. It performs the job 
of converting the parallel byte date from the CPU to a 
serial data stream including start, stop, and parity bits. 
For a more detailed description of how this LSI circuit 
performs these functions, refer to the TR1602 data 
sheets and application notes. The transmit and receive 
clock rates that the TR1602 needs are supplied by the 
Baud rate generator (BR19411). This circuit takes the 
5.0688 MHz supplied by the CPU board and the 
programmed information received from the CPU over 
the data bus and divides the basic clock rate to provide 
two clocks. The rates available from the BRG go from 
50 Baud to 19200 Baud. See the BRG table for the 
complete list. 



BRG PROGRAMMING TABLE 



TRANSMIT OR RECEIVE SUPPORTED BY 

NIBBLE LOADED BAUD RATE 16X CLOCK FREQUENCY SETCOM 

0H 50 0.8 kHz yes 

1H 75 1.2 kHz yes 

2H 110 1.76 kHz yes 

3H 134.5 2.1523 kHz yes 

4H 150 2.4 kHz yes 

5H 300 4.8 kHz yes 

6H 600 9.6 kHz yes 

7H 1200 19.2 kHz yes 

8H 1800 28.8 kHz yes 

9H 2000 32.081 kHz yes 

AH 2400 38.4 kHz yes 

BH 3600 57.6 kHz yes 

CH 4800 76.8 kHz yes 

DH 7200 115.2 kHz yes 

EH 9600 153.6 kHz yes 

FH 19,200 307.2 kHz yes 
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The RS-232C board is a port mapped device and the ports 
used are E8 to EB. Following is a description of each port 
on both input and output. 



9.2 PINOUT LISTING 

The following list is a pinout description of the DB-25 con- 
nector (P1). 



ORT 


INPUT 


OUTPUT 


PIN# 


SIGNAL 


E8 


Modem status 


Master Reset, enables 










UART control register 


1 


PGND (Protective Ground) 






load 


2 
3 


TD (Transmit Data) 
RD (Receive Data) 


EA 


UART status 


UART control register 


4 


RTS (Request To Send) 






load and modem control 


5 
6 


CTS (Clear To Send) 
DSR (Data Set Ready) 


E9 


Not Used 


Baud rate register load 


7 


SGND (Signal Ground) 






enable bit 


8 
20 


CD (Carrier Detect) 

DTR (Data Terminal Ready) 


EB 


Receiver Holding 
register 


Transmitter Holding 
register 


22 


Rl (Ring Indicate) 



Interrupts are supported on the RS-232C option board by 
the Interrupt mask register (U10) and the Status register 
(U9) which allows the CPU to see which kind of interrupt 
has occurred. Interrupts can be generated on receiver data 
register full, transmitter register empty, and any one of the 
errors — parity, framing, or data overun. This allows a min- 
imum of CPU overhead in transferring data to or from the 
UART. The interrupt mask register is port E0 (write) and the 
interrupt status register is port E0 (read). Refer to the IO 
Port description for a full breakdown of all interrupts and 
their bit positions. 

The Model 4 RS-232C board is functionally identical to 
the Model I RS-232 board with the following exceptions: 
Interrupts are supported, there are no sense switches for con- 
figuring the interface, there is no COM/TERM switch for re- 
versing the function of pins 2 and 3 on the DB-25, and the 
DC to DC converter is not required since +12V and -12V are 
provided by the internal power supply. Other differences 
include three additional interface outputs and no crystal for 
the BRG. All Model I software written for the RS-232 inter- 
face is compatable with the Model 4 RS-232C option board, 
provided that the software does not use the sense switches to 
configure the interface. The programmer can get around this 
problem by directly programming the BRG and UART for 
the desired configuration or by using the SETCOM command 
of the disk operating system to configure the interface. The 
TRS-80 RS-232C Interface hardware manual has a good dis- 
cussion of the RS-232C standard and specific programming 
examples (Catalog Number 26-1145). 
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9.3 PORT AND BIT ASSIGNMENTS 



PORT E8H 

OUTPUT: MASTER RESET 

INPUT: MODEM STATUS REGISTER 



An output to this port (and data), performs a master reset to the UART and enables the control register 
load enable bit. The following table details the bit definitions for an input from port E8H. 



DATA BIT 


FUNCTION 


D7 


Clear To Send, Pin 5 DB-25 


D6 


Data Set Ready, Pin 6 DB-25 


D5 


Carrier Detect, Pin 8 DB-25 


D4 


Ring Indicator, Pin 22 DB-25 


D3 


Not Used 


D2 


Not Used 


D1 


Not Used 


D0 


Receiver Input, UART Pin 20 DB-25 



PORT E9H 

OUTPUT: BAUD RATE LOAD 

INPUT: NOT USED 

An output to this port loads the Baud rate generator with a code which corresponds to the desired receive 
and transmit Baud rate as outlined in the BRG Programming Table. The low order nibble of the data 
output to this port determines the receiver Baud rate, while the high order nibble determines the trans- 
mit Baud rate. 



PORT EAH 

OUTPUT: UART AND MODEM CONTROL 

INPUT: UART STATUS 

An output to this port loads the UART Control register if the enable bit for this function is set (D1 port 
E8H = 1). The UART Control register is five bits wide (D7 - D3) leaving three bits for modem control 
(D2 - D0). Three more modem control bits were added by allowing software to enable or disable the 
UART Control register. The tables below summarize the bit allocations with the UART Control register 
enabled and disabled. 

PORT EAH OUTPUT BITS WITH UART CONTROL REGISTER ENABLED 

DATA BIT FUNCTION 

D7 Even Parity Enable, 1 =even, =odd 

D6 Word Length Select 1 

D5 Word Length Select 2 

D4 Stop Bit Select, 1 = two stop bits, = one stop bit 

D3 Parity Inhibit, 1 = disable parity 

D2 Break = disable transmit data (continuous space) 

D1 Data Terminal Ready, Pin 20 DB-25 

D0 Request To Send, Pin 4 DB-25 



171 



PORT EAH OUTPUT BITS WITH UART CONTROL REGISTER DISABLED 



DATA BIT 



FUNCTION 



D7 
D6 
D5 
D4 
D3 
D2 
D1 
D0 



Not Used 
Not Used 

Secondary unassigned, Pin 18 DB-25 
Secondary Transmit Data, Pin 14 DB-25 
Secondary Request To Send, Pin 19 DB-25 
Break = disable Transmit Data (continuous space) 
Data Terminal Ready, Pin 20 DB-25 
Request To Send, Pin 4 DB-25 



PORT EAH INPUT BITS 



DATA BITS 



FUNCTION 



D7 
D6 
D5 
D4 
D3 
D2 
D1 
D0 



Data Received, 1 = condition true 
Transmitter Holding register empty. 
Overrun error, 1 = condition true 
Framing error, 1 = condition true 
Parity error, 1 = condition true 
Not Used 
Not Used 
Not Used 



1 = condition true 



PORT EBH 

OUTPUT: TRANSMITTER HOLDING REGISTER 

INPUT: RECEIVER HOLDING REGISTER 

An output to this port loads the UART Transmitter Holding register with a word to be transmitted, 
as soon as the last word loaded in the holding register is transmitted. This register should never be loaded 
until the Transmitter Holding register empty bit (port EAH) is true. An input from this port reads the 
last word received from the UART received data holding register. This register should not be read until 
the data received bit (port EAH) is true. 



172 



RS-Z32-C INTERFACE 



CONNECTOR 
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RS-232 BOARD TO CPU BOARD SIGNAL DESCRIPTION 
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SCHEMATIC DIAGRAM #8000076, RS232C, CHNG B 
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COMPONENT LOCATION/CIRCUIT TRACE, RS-232C PC BOARD - COMPONENT SIDE 
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CIRCUIT TRACE, RS-232C PC BOARD - SOLDER SIDE 
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PARTS LIST RS-232C PC BOARD 



SYMBOL 



DESCRIPTION 



MANUFACTURER'S 
PART NUMBER 



RADIO SHACK 
PART NUMBER 



CAPACITORS 



CI 
C2 
C3 
C4 
C5 
C6 
C7 
C8 
C9 



10/jF , 1 6V , radial (optional) 
IOjuF, 16V, radial (optional) 
0.1/uF, 50V, monolithic, radial 
0.1/iF, 50V, monolithic, radial 
0.1/iF, 50V, monolithic, radial 
0.1/iF/ 50V, monolithic, radial 
0.1/iF, 50V, monolithic, radial 
10/iF, 16V, radial 
10/iF, 16V, radial 



832-6101 
832-6101 
8384104 
8384104 
838-4104 
838-4104 
8384104 
832-6101 
832-6101 



ACC106QDAP 

ACC106QDAP 

ACC104QJAP 

ACC104QJAP 

ACC104QJAP 

ACC104QJAP 

ACC104QJAP 

ACC106QDAP 

ACC106QDAP 



CONNECTORS 



PI 
P2 
P3 



DB-25 Connector 
20 pos. right angle 
4 pos. right angle 



851-9030 
851-9078 
851-9079 



AJ6977 



INTEGRATED CIRCUITS 



U1 
U2 
U3 
U4 
U5 
U6 
U7 
U8 
U9 
U10 
U11 
U12 
U13 
U14 
U15 
U16 



BR 1941 -L, Dual Baud C 
TR1602B,UART 
74LS244, Octal Buffer 
74LS367,Hex Buffer 
74LS367, Hex Buffer 
74LS174,Quad "D" Flip-Flop 
7404, Hex Inverter 
74LS139,Dual Decoder 
74LS368, Hex Buffer 
74LS174,Quad "D" Flip-Flop 
MC1489,Quad Line Driver 
MC1488,Quad Line Driver 
74LS27, NOR gate 
74LS38,NAND Buffer 
MC1489,Quad Line Driver 
MC1488,Quad Line Driver 



804-6941 
804-5602 
802-0244 
802-0367 
802-0367 
802-0174 

802-0139 
802-0368 
802-0174 
805-0189 
805-0188 
802-0027 
802-0038 
805-0189 
805-0188 



AMX3921 
AMX3865 
AMX3864 
AMX3567 
AMX3567 
AMX3565 
AMX3655 
AMX3800 
AMX3568 
AMX3565 
AMX3868 
AMX3867 

AMX4328 
AMX3868 
AMX3867 



R1 
R2 

R3 
R4 



4.7K, 1/4W,5% 
4.7K, 1/4W,5% (optional) 
6.2K, 1/4W, 5% (optional) 
4.7 K, 1/4W, 5% 



RESISTORS 



MISCELLANEOUS 



820-7247 
820-7247 

820-7247 



AN0247EEC 

AN0247EEC 

AMX4658 

AN0247EEC 



Cable, 20 pos., 4.5", flat 
Socket, 18 pin 
Socket, 40 pin 



845-9020 
850-9006 
850-9002 



AW2631 

AJ6701 

AJ6580 
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SOFTWARE 
SOFTWARE 
SOFTWARE 
SOFTWARE 
SOFTWARE 
SOFTWARE 
SOFTWARE 
SOFTWARE 
SOFTWARE 
SOFTWARE 




SOFTWARE 
SOFTWARE 
SOFTWARE 



ia# a n 



PART IE 
SOI r TWARE 
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1/Disk Organization 



TRSDOS Version 6 can be used with 5 1 A" single-sided floppy diskettes and 
with hard disk. Floppy diskettes can be either single- or double-density. See the 
charts below for the number of sectors per track, number of cylinders, and so 
on for each type of disk. (Sectors and cylinders are numbered starting with 0.) 



Single-Density Floppy Diskette 



Bytes Sectors Sectors Granules Tracks Cylinders 

per per per per per per Total 

Sector Granule Track* Track Cylinder Drive Bytes 

256 256 

5 1 ,280 

(10) 2 2,560 

1 - 2,560 

40 102,400 

256 5 (10) 2 1 40 102,400 

(100K)** 



Double-Density Floppy Diskette 



Bytes Sectors Sectors Granules Tracks Cylinders 
per per per per per per Total 

Sector Granule Track* Track Cylinder Drive Bytes 

256 256 

6 1 ,536 

(18) 3 4,608 

1 4,608 

40 184,320 

256 6 (18) 3 1 40 184,320 

(180K)** 

The number of sectors per track is not included in the calculation because it 
is equal to the number of sectors per granule times the number of granules 
per track. (5 x 2 = 1 for single density, 6 x 3 = 18 for double density, and 
16x2 = 32 for hard disk.) 

**Note that this figure is the total amount of space in the given format. Keep in 
mind that an entire cylinder is used for the directory and at least one granule 
is used for the bootstrap code. This leaves 96.25K available for use on a 
single-density data disk and 174K on a double-density data disk. 
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Note: Because of continual advancements in hard disk technology, the number 
of tracks and the number of tracks per cylinder may change. Therfore, any infor- 
mation that comes with your hard disk drive(s) supersedes the information in 

the table below. 

Bytes Sectors Sectors Granules Tracks Cylinders 
per per per per per per Total 

Sector Granule Track* Track Cylinder Drive Bytes 

256 256 

■) e 4,096 

(32) 2 8,192 

4 32768 

153 5,013,504 

256 16 (32) 2 4 153 5,013,504 

(4.896K) 

The number of sectors per track is not included in the calculation because it is 
equal to the number of sectors per granule times the number of granules per 
track. (5 x 2 = 1 for single density, 6 x 3 = 18 for double density, and 
16x2 = 32 for hard disk.) 



Disk Space Available to the User 



One granule on cylinder of each disk is reserved for the system. It contains 
information about where the directory is located on that disk. If the disk contains 
an operating system, then all of cylinder is reserved. This area contains infor- 
mation used to load TRSDOS when you press the reset button. 

One complete cylinder is reserved for the directory, the granule allocation table 
(GAT), and the hash index table (HIT). (On single-sided diskettes, one cylinder 
is the same as one track.) The number of this cylinder varies, depending on the 
size and type of disk. Also, if any portion of the cylinder normally used for the 
directory is flawed, TRSDOS uses another cylinder for the directory. You can 
find out where the FORMAT utility has placed the directory by using the 
Free -.drive command. 

On hard disks, an additional cylinder (cylinder 1) is reserved for use in case 
your disk drive requires service. This provides an area for the technician to write 
on the disk without harming any data. (If you bring your hard disk in for service, 
you should try to back up the contents of the disk first, just to be safe.) 



Unit of Allocation 



The smallest unit of disk space that the system can allocate to a file is a gran- 
ule. A granule is made up of a set of sectors that are adjacent to one another 
on the disk. The number of sectors in a granule depends on the type and size 
of the disk. See the charts on the previous two pages for some typical sizes. 



184 



2/Disk Files 



liethods ©f File Allocation 



TRSDOS provides two ways to allocate disk space for files: dynamic allocation 
and pre-allocation. 

Dynamic Allocation 

With dynamic allocation, TRSDOS allocates granules only at the time of write. 
For example, when a file is first opened for output, no space is allocated. The 
first allocation of space is done at the first write. Additional space is added as 
required by further writes. 

With dynamically allocated files, unused granules are de-allocated (recovered) 
when the file is closed. 

Unless you execute the CREATE system command, TRSDOS uses dynamic 
allocation. 

Pre-Allocation 

With pre-allocation, the file is allocated a specified number of granules when it 
is created. Pre-allocated files can be created only by the system command 
CREATE. (See the Disk System Owner's Manual for more information on 
CREATE.) 

TRSDOS automatically extends a pre-allocated file as needed. However, it 
does not de-allocate unused granules when a pre-allocated file is closed. To 
reduce the size of a pre-allocated file, you must copy it to a dynamically allo- 
cated file. The COPY (CLONE = N) system command does this automatically 

Files that have been pre-allocated have a 'C by their names in a directory 
listing. 



Record Lenqth 



TRSDOS transfers data to and from disks one sector at a time. These sectors 
are 256-byte blocks, and are also called the system's "physical" records. 

You deal with records that are 256 bytes in length or smaller, depending on 
what size record you want to work with. These are known as "logical" records. 

You set the size of the logical records in a file when you open the file for the first 
time. The size is the number of bytes to be kept in each record. There may be 
from 1 to 256 bytes per logical record. 

The operating system automatically accumulates your logical records and 
stores them in physical records. Since physical records are always 256 bytes in 
length, there may be one or more logical records stored in each physical record. 
When the records are read back from disk, the system automatically returns 
one logical record at a time. These actions are known as "blocking" and "de- 
blocking," or "spanning." 

For example, if the logical record length is 200, sectors 1 and 2 look like this: 
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'44 bytes 




Since they are completely handled by the operating system, you do not need to 
concern yourself with physical records, sectors, granules, tracks, and so on. 
This is to your benefit, as the number of sectors per granule varies from disk to 
disk. Also, physical record lengths may change in future versions of TRSDOS, 
but the concept of logical records will not. 

Note: All files are fixed-length record files with TRSDOS Version 6. 



Record Processing Capabilities 



TRSDOS allows both direct and sequential file access. 

Direct access (sometimes called "random access") lets you process records in 
any sequence you specify. 

Sequential access allows you to process records in sequence: record n, n + 1, 
n+2, and so on. With sequential access, you do not specify a record number. 
Instead, TRSDOS accesses the record that follows the last record processed, 
starting with record 0. 

With sequential access files, use the @READ supervisor call to read the next 
record, and the ©WRITE or @VER supervisor call to write the next record. 
(When the file is first opened, processing starts at record 0. You can use 
@PEOF to position to the end of file.) 

To read or write to a direct access file, use the @POSN supervisor call to posi- 
tion to a specified record. Then use ©READ, ©WRITE, or ©VER as desired. 
Once ©POSN has been used, the End of File (EOF) marker will not move, 
unless the file is extended by writing past the current EOF position. 

Record Numbers 

Using direct (random) access, you can access up to 65,536 records. Record 
numbers start at and go to 65535. 

Using a file sequentially, you can access up to 16,777,216 bytes. To calculate 
the number of records you can access sequentially, use the formula: 

16,777,216 4- logical record length = number of sequential 

records allowed 
Below are some examples. 

lftheLRL = 256, then: 

16,777,216 -r- 256 = 65,536 records 

If the LRL = 128, then: 

16,777,216 •*• 128 = 131,072 records 

lftheLRL= 50, then: 

1 6,777,21 6 + 50 = 335,544 records 



lfthei_RL= 1,then: 

16,777,216 -r 



1=16,777,216 records 
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3/TR6D08 File Descriptions 



This section describes four types of files found on your TRSDOS master disk- 
ette (system files, utilities, driver programs, and filter programs) and explains 
their functions. It also describes how to construct a minimum system disk for 
running applications packages. 



System Files (/SYS) 



TRSDOS Version 6 would occupy considerable memory space if all of it were 
resident in memory at any one time. To minimize the amount of memory 
reserved for system use, TRSDOS uses overlays. 

Using an overlay-driven system involves some compromise. While a user's 
application is in progress, different overlays may need to be loaded to perform 
certain activities requested of the system. This could cause the system to run 
slightly slower than a system which has more of its file access routines always 
resident in memory. 

The use of overlays also requires that a SYSTEM disk usually be available in 
Drive (the system drive). Since the disk containing the operating system and 
its utilities leaves little space available to the user, you may want to remove cer- 
tain parts of the system software not needed while a particular application is 
running. You may in fact discover that your day-to-day operations need only a 
minimal TRSDOS configuration. The greater the number of system functions 
unnecessary for your application, the more space you can have available for a 
"working" system disk. Use the PURGE or REMOVE library command to elim- 
inate unneeded system files from the disk. 

The following paragraphs describe the functions performed by each system 
overlay. (In the display produced by the DIR (SYS) library command, the system 
overlays are identified by the file extension /SYS.) 

Note: Two system files are put on the disk during formatting. They are DIR/SYS 
and BOOT/SYS. These files should never be copied from one disk to another 
or REMOVEd. TRSDOS automatically updates any information necessary 
when performing a backup. 

SYS0/SYS 

This is not an overlay. It contains the resident part of the operating system 
(SYSRES). It is also needed to dynamically allocate file space used when writ- 
ing files. Any disk used for booting the system must contain SYS0. It can be 
purged from disks not used for booting. 

SYS1/SYS 

This overlay contains the TRSDOS command interpreter and the routines for 
processing the @CMNDI, @CMNDR, @FEXT, @FSPEC, and @PARAM sys- 
tem vectors. This overlay must be available on all SYSTEM disks. 

SYS2/SYS 

This overlay is used for opening or initializing disk files and logical devices. It 
also contains routines for processing the @CKDRV, @GTDCB, and @RENAM 
system vectors, and routines for hashing file specifications and passwords. 
This overlay must be available on all SYSTEM disks. 

SYS3/SYS 

This overlay contains all of the system routines needed to close files and logical 
devices. It also contains the routines needed to service the @FNAME system 
vector. This overlay must not be removed from the disk. 
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SYS4/SYS 

This overlay contains the system error dictionary, it is needed to issue such 
messages as "File not found," "Directory read error," etc. If you decide to 
remove this overlay from your working SYSTEM disk, all system errors will pro- 
duce the error message "SYS ERROR." It is recommended that you not remove 
this overlay, especially since it occupies only one granule of space. 

SYS5/SYS 

This is the "ghost" debugger. It is needed if you intend to test out machine lan- 
guage application software by using the TRSDOS DEBUG library command. If 
your operation will not require this debugging tool, you may purge this overlay. 

SYS6/SYS 

This overlay contains all of the routines necessary to service the library com- 
mands identified as "Library A" by the LIB command. This represents the pri- 
mary library functions. Only very limited use can be made of TRSDOS if this 
overlay is removed from your working SYSTEM disk. 

SYS7/SYS 

This overlay contains all of the routines necessary to service the library com- 
mands identified as "Library B" by the LIB command. A great deal of use can 
be made of TRSDOS even without this overlay. It performs specialized func- 
tions that may not be needed in the operation of specific applications. You can 
purge this overlay if you decide it is not needed on a working SYSTEM disk. 

SYS8/SYS 

This overlay contains all of the routines necessary to service the library com- 
mands identified as "Library C" by the LIB command. A great deal of use can 
be made of TRSDOS even without this overlay. It performs specialized func- 
tions that may not be needed in the operation of specific applications. You can 
purge this overlay if you decide it is not needed on a working SYSTEM disk. 

SYS9/SYS 

This overlay contains the routines necessary to service the extended DEBUG 
commands available after a DEBUG (EXT) is performed. This overlay may be 
purged if you will not need the extended DEBUG commands while running your 
application. If you remove SYS5/SYS, then you may as well remove SYS9/SYS, 
as it would serve no useful purpose. 

SYS10/SYS 

This system overlay contains the procedures necessary to service the request 
to remove a file. It should remain on your working SYSTEM disks. 

SYS11/SYS 

This overlay contains all of the procedures necessary to perform the Job Con- 
trol Language execution phase. You may remove this overlay from your working 
disks if you do not intend to execute any JCL functions. If SYS6/SYS (which 
contains the DO command) has been removed, keeping this overlay would 
serve no purpose. 

SYS12/SYS 

This system overlay contains the routines that service the @DODIR, 
@GTMOD, and @RAMDIR system vectors. It should remain on your disks. 

SYS13/SYS 

This overlay is reserved for future system use. It contains no code and takes up 
no space on the disk. You may remove this overlay if you wish to free up its 
directory slot. 
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Utility Programs 



BACKUP — Used to duplicate data from one disk to another. 

COMM — A communications package for use with the RS-232C hardware. 

CONV — Used to copy files from Model III TRSDOS to TRSDOS Version 6. 

FORMAT — Used to put track, sector, and directory information on a disk. 

LOG — Used to log in a double-sided diskette in Drive 0. Also updates the 
Drive Code Table information as with the DEVICE library 
command. 

PATCH — Used to make changes to existing files. 

REPAIR — Used to correct certain information on non-TRSDOS formatted 
diskettes. 

TAPE100 — A disk/tape, tape/disk utility for cassette tape operations with the 
TRS-80 Model 100. 



Device Driver Programs 



COM/DVR 
FLOPPY/DCT 



The RS-232C communications driver. 

■ Configures floppy drives in the system. Not needed with a 
floppy-only system. 



JL/DVR — The Joblog driver program. 

MEMDISK/DCT — Used to establish a pseudo floppy drive in memory. 



Flier Programs 



CLICK/FLT — Produces a short tone as each key is pressed. 

FORMS/FLT — Used to select printer parameters and perform character 
translation. 

KSM/FLT — The Keystroke Multiply feature, which allows the assigning 

of user-determined phrases to alphabetic keys. 



Creating a Minimum Configuration Disk 



All files except certain /SYS files may be purged from your Drive disk. Addi- 
tionally, if you place the needed /SYS files in high memory with the SYSTEM 
(SYSRES) command, it will be possible to run with a minimum configuration 
disk in Drive after booting the system. Keep the following points in mind when 
purging system files: 

• For operation, SYS files 1, 2, 3, 4, 10, and 12 should remain on the Drive 
disk or be resident in memory. 

• SYS2 must be on the system disk if a configuration file is to be loaded. 
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• SYS11 must be present only if any JCL files will be used. 

• All three libraries (SYS files 6, 7, and 8) may be purged if no library com- 
mand will be used. 

• SYS5 and SYS9 may be purged if the system DEBUG package is not 
needed. 

• SYS0 may be removed from any disk not used for booting. 

• SYS11 (the JCL processor) and SYS6 (containing the DO library com- 
mand) must both be on the disk if the DO command is to be used. Also, 
if you remove SYS6, you may as well remove SYS11. 

• SYS13 (reserved for future use) may be removed to free up an additional 
directory slot. 

The presence of any utility, driver, or filter program is dependent upon your indi- 
vidual needs. You can save most of the TRSDOS features in a configuration file 
using the SYSTEM (SYSGEN) command, so the driver and filter programs will 
not be needed in run time applications. 

The owner (update) passwords for TRSDOS files are as follows: 

File Type Extension Owner Password 



System files (/SYS) LSIDOS 

Filter files (/FLT) FILTER 

Driver files (/DVR) DRIVER 

Utility files (7CMD) UTILITY 

BASIC BASIC 

BASIC overlays (/OV$) BASIC 

CONFIG/SYS CCC 

Drive Code Table (/DCT) UTILITY 
Initializer 
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4/Dewice Act 



Device Control Block (DCB) 



The Device Control Block (DCB) is an area of memory that contains informa- 
tion used to interface the operating system with various logical devices. These 
devices include the keyboard (*KI), the video display (*DO), a printer (*PR), a 
communications line (*CL), and other devices that you may define. 

The following information describes each assigned DCB byte. 

DCB + (TYPE Byte) 

Bit 7 — If set to "1," the Device Control Block is actually a File Control Block 
(FCB) with the file open. Since DCBs and FCBs are similar, and 
devices may be routed to files, a "device" with this bit set indicates 
a routing to a file. 

Bit 6 — If set to "1," the device defined by the DCB is filtered or is a device 
filter. 

Bit 5 — If set to "1," the device defined by the DCB is linked. 

Bit 4 — If set to "1," the device defined by the DCB is routed. 

Bit 3 — If set to "1," the device defined by the DCB is a NIL device. Any out- 
put directed to the device is discarded. For any input request, the 
character returned is a null (ASCII value 0). 

Bit 2 — If set to "1," the device defined by the DCB can handle requests 
generated by the @CTL supervisor call. See the section on Super- 
visor Calls for more information. 

Bit 1 — If set to "1," the device defined by the DCB can handle output 
requests which normally come from the @PUT supervisor call. 

Bit — If set to "1," the device defined by the DCB can handle requests for 
input which normally come from the @GET supervisor call. 

DCB + 1 and DCB + 2 

Contain the address of the driver routine that supports the hardware assigned 
to this DCB. (In the case of a routed or linked device, the vector may point to 
another DCB.) 

DCB + 3 through DCB + 5 

Reserved for system use. 

DCB + 6 and DCB + 7 

These locations normally contain the two alphabetic characters of the devspec. 
The system uses the devspec as a reference in searching the device control 
block tables. 
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»mory Header 



Modules that TRSDOS loads into memory (filters, drivers, and other memory 
modules such as a SPOOL buffer or the extended DEBUG code) are identified 
by a standard front-end header: 



BEGINS JR START 



DEFW END-1 



DEFB 1( 



DEFM 'NAMESTRING 



MODDCBs DEFW $-$ 



DEFW 



3 Go to actual code 

ibesinnins 

5 C o n tains the highest byte 

5 o f memory 

I u s e d by the module 

5 Length of name* 1-15 

?cha racte rs 3 

Ibits 4-7 reserved for 

3 s y s t e m use 

3Up to 15 alphanumeric 

3characters> with the first 

Scharacter A - Z . This should 

3 b e a unique name to 

ipositiuely identify the 

5 m o d u 1 e . 

3DCB pointing to this 

I module (if applicable) 

3 S p a r e system pointer _ 

IRESERVED 



START: 



Any additional data storage Joes here 



Start of actual program code 



ENDs 



EOU $ 



As explained under the @GTMOD SVC in the "Supervisor Call" section, the 
location of a specific header can be found provided all modules that are put into 
memory use this header structure. You can locate the data area for a module 
by using @GTMOD to find the start of the header and then indexing in to the 
data area. 
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5/Driwe Access 



Drive Code Table (OCT) 



TRSDOS uses a Drive Code Table (DCT) to interface the operating system with 
specific disk driver routines. Note especially the fields that specify the allocation 
scheme for a given drive. This data is essential in the allocation and accessi- 
bility of file records. 

The DCT contains eight 10-byte positions — one for each logical drive desig- 
nated 0-7. TRSDOS supports a standard configuration of four floppy drives. 
This is the default initialization when TRSDOS is loaded. 

Here is the Drive Code Table layout: 

DCT + 

This is the first byte of a 3-byte vector to the disk I/O driver routines. This byte 
is normally X'C3.' If the drive is disabled or has not been configured (see the 
SYSTEM command in the Disk System Owner's Manual), this byte is a RET 
instruction (X'C9'). 

DCT+1 and DCT +2 

Contain the entry address of the routines that drive the physical hardware. 

DCT +3 

Contains a series of flags for drive specifications. 

Bit 7 — Set to "1" if the drive is software write protected, "0" if it is not. (See 
the SYSTEM command in the Disk System Owner's Manual.) 

Bit 6 — Set to "1" for DDEN (double density), or "0" for SDEN (single 
density). 

Bit 5 — Set to "1" if the drive is an 8" drive. Set to "0" if it is a 5 1 /4" drive. 

Bit 4 — A "1" causes the selection of the disk's second side. The first side 
is selected if this bit is "0." This bit value matches the side indicator 
bit in the sector header written by the Floppy Disk Controller 
(FDC). 

Bit 3 — A "1" indicates a hard drive (Winchester). A "0" denotes a floppy 
drive (5 1 /4" or 8"). 

Bit 2 — Indicates the time delay between selection of a 5 1 /4" drive and the 
first poll of the status register. A "1" value indicates 0.5 second and 
a "0" indicates 1.0 second. See the SYSTEM command in the Disk 
System Owner's Manual for more details. 

If the drive is a hard drive.this bit indicates either a fixed or remov- 
able disk: "1"= fixed, "0" = removable. 

Bits 1 and — Contain the step rate specification for the Floppy Disk Con- 
troller. (See the SYSTEM command in the Disk System Owner's 
Manual.) In the case of a hard drive, this field may indicate the drive 
address (0-3). 

DCT + 4 

Contains additional drive specifications. 

Bit 7 — Reserved for future use. In order to maintain compatibility with 
future releases of TRSDOS, do not use this bit. 

Bit 6 — If "1," the controller is capable of double-density mode. 
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Bit 5 — "1" indicates that this is a 2-sided floppy diskette; "0" indicates a 
1-sided floppy disk. Do not confuse this bit with Bit 4 of DCT + 3. 
This bit shows if the disk is double-sided; Bit 4 of DCT + 3 tells the 
controller what side the current I/O is to be on. 

If the hard drive bit (DCT + 3, Bit 3) is set, a "1" denotes double the 
cylinder count stored in DCT + 6. (This implies that a logical cylin- 
der is made up of two physical cylinders.) 

Bit 4 — If "1" indicates an alien (non-standard) disk controller. 

Bits 0-3 — Contain the physical drive address by bit selection (0001, 0010, 
0100, and 1000 equal logical Drives 0, 1, 2, and 3, respectively, in 
a default system). The system supports a translation only where no 
more than one bit can be set. 



If the alien bit (Bit 4) is set, these bits may indicate the starting head 
number. 



DCT + 5 



Contains the current cylinder position of the drive. It normally stores a copy of 
the Floppy Disk Controller's track register contents whenever the FDC is 
selected for access to this drive. It can then be used to reload the track register 
whenever the FDC is reselected. 

If the alien bit (DCT + 4, Bit 4) is set, DCT + 5 may contain the drive select code 
for the alien controller. 

DCT+6 

Contains the highest numbered cylinder on the drive. Since cylinders are num- 
bered from zero, a 35-track drive is recorded as X'22,' a 40-track drive as X'27/ 
and an 80-track drive as X'4F If the hard drive bit (DCT + 3, Bit 3) is set, the true 
cylinder count depends on DCT + 4, Bit 5. If that bit is a "1," DCT + 6 contains 
only half of the true cylinder count. 

DCT + 7 

Contains allocation information. 

Bits 5-7 — Contain the number of heads for a hard drive. 

Bits 0-4 — Contain the highest numbered sector relative to zero. A 10- 
sector-per-track drive would show X'09.' If DCT + 4, Bit 5 indicates 
2-sided operation, the sectors per cylinder equals twice this 
number. 

DCT + 8 

Contains additional allocation information. 

Bits 5-7— Contain the number of granules per track allocated in the for- 
matting process. If DCT + 4, Bit 5 indicates 2-sided operation, the 
granules per cylinder equals twice this number. For a hard drive, 
this number is the total granules per cylinder. 

Bits 0-4— Contain the number of sectors per granule that was used in the 
formatting operation. 

DCT + 9 

Contains the number of the cylinder where the directory is located. For any 
directory access, the system first attempts to use this value to read the direc- 
tory. If this operation is unsuccessful, the system examines the BOOT granule 
(cylinder 0) directory address byte. 

Bytes DCT + 6, DCT + 7, and DCT + 8 must relate without conflicts. That is, the 
highest numbered sector ( + 1) divided by the number of sectors per granule 
( + 1 ) must equal the number of granules per track ( + 1 ). 
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Disk 1/0 Table 



TRSDOS interfaces with hardware peripherals by means of software drivers. 
The drivers are, in general, coupled to the operating system through data 
parameters stored in the system's many tables. In this way, hardware not cur- 
rently supported by TRSDOS can easily be supported by generating driver soft- 
ware and updating the system tables. 

Disk drive sub-systems (such as controllers forSVV drives, 8" drives, and hard 
disk drives) have many parameters addressed in the Drive Code Table (DCT). 
Besides those operating parameters, controllers also require various com- 
mands (SELECT, SECTOR READ, SECTOR WRITE, and so on) to control the 
physical devices. TRSDOS has defined command conventions to deal with 
most commands available on standard Disk Controllers. 

The function value (hexadecimal or decimal) you wish to pass to the driver 
should go in register B. The available functions are: 

Operation Performed 



Hex 



Dec 



Function 



X00' 





DCSTAT 


X'OV 


1 


SELECT 


X02' 


2 


DCINIT 


X'03" 


3 


DCRES 


X'04' 


4 


RSTOR 


X'05' 


5 


STEPI 


X'06' 


6 


SEEK 


X'07' 


7 


TSTBSY 


X'08' 


8 


RDHDR 


X'09' 


9 


RDSEC 


X'OA' 


10 


VRSEC 


X'0B' 


11 


RDTRK 


X'0C 


12 


HDFMT 


X'0D' 


13 


WRSEC 


X'0E' 


14 


WRSYS 


X'OF 


15 


WRTRK 


Function codes X'10' to X' 



Test to see if drive is assigned in DCT 
Select a new drive and return status 
Set to cylinder 0, restore, set side 
Reset the Floppy Disk Controller 
Issue FDC RESTORE command 
Issue FDC STEP IN command 
Seek a cylinder 

Test to see if requested drive is busy 
Read sector header information 
Read sector 

Verify if the sector is readable 
Issue an FDC track read command 
Format the device 
Write a sector 

Write a system sector (for example, directory) 
Issue an FDC track write command 
are reserved for future use. 



Directory Records (DIREC) 



The directory contains information needed to access all files on the disk. The 
directory records section is limited to a maximum of 32 sectors because of 
physical limitations in the Hash Index Table. Two additional sectors in the direc- 
tory cylinder are used by the system for the Granule Allocation Table and the 
Hash Index Table. The directory is contained on one cylinder. Thus, a 1 0-sector- 
per-cylinder formatted disk has, at most, eight directory sectors. See the sec- 
tion on the Hash Index Table for the formula to calculate the number of directory 
sectors. 

A directory record is 32 bytes in length. Each directory sector contains eight 
directory records (256/32 = 8). On system disks, the first two directory records 
of the first eight directory sectors are reserved for system overlays. The total 
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Sectors 




User Files 


User 


per 


Directory 


on Data 


Files on 


Cylinder 


Sectors 


Disk" 


SYS Disk 


10 


8 


62 


48 


20 


18 


142 


128 


18 


16 


126 


112 


36 


32 


254 


240 


16 


14 


110 


96 


32 


30 


238 


224 


30 


28 


222 


208 


60 


32 


254 


240 



number of files possible on a disk equals the number of directory sectors times 
eight (since 256/32 = 8). The number available for use is reduced by 16 on sys- 
tem disks to account for those record slots reserved for the operating system. 
The following table shows the directory record capacity (file capacity) of each 
format type. The dash suffix (-1 or -2) on the items in the density column rep- 
resents the number of sides formatted (for example, SDEN-1 means single 
density, 1-sided). 



5" SDEN-1 
5" SDEN-2 
5" DDEN-1 
5" DDEN-2 
8" SDEN-1 
8" SDEN-2 
8" DDEN-1 
8" DDEN-2 
5-MEG HARD* 

*Hard drive format depends on the drive size and type, as well as the user's 
division of the physical drive into logical drives. After setting up and format- 
ting the drive, you can use the FREE library command to see the available 
files. 

**Note: Two directory records are reserved for BOOT/SYS and DIR/SYS, and 
are not included in the figures for this column. 

TRSDOS Version 6 is upward compatible with other TRSDOS 2.3 compatible 
operating systems in its directory format. The data contained in the directory 
has been extended. An SVC is included to either display an abbreviated direc- 
tory or place its data in a user-defined buffer area. For detailed information, see 
the @DODIR and @RAMDIR SVCs. 

The following information describes the contents of each directory field: 

DIR + i 

Contains all attributes of the designated file. 

Bit 7 — If "0," this flag indicates that the directory record is the file's primary 
directory entry (FPDE). If "1," the directory record is one of the file's 
extended directory entries (FXDE). Since a directory entry can 
contain information on up to four extents (see notes on the extent 
fields, beginning with DIR + 22), a file that is fractured into more 
than four extents requires additional directory records. 

Bit 6— -Specifies a SYStem file if "1," a nonsystem file if "0." 

Bit 5— If set to "1," indicates a Partition Data Set (PDS) file. 

Bit 4 — Indicates whether the directory record is in use or not. If set to "1," 
the record is in use. If "0," the directory record is not active, 
although it may appear to contain directory information. In contrast 
to some operating systems that zero out the directory record when 
you remove a file, TRSDOS only resets this bit to zero. 

Bit 3 — Specifies the visibility. If "1," the file is INVisible to a directory dis- 
play or other library function where visibility is a parameter. If a "0," 
then the file is Visible. (The file can be referenced if specified by 
name by an @INIT or ©OPEN SVC.) 

Bits 0-2 — Contain the USER protection level of the file. The 3-bit binary 
value is one of the following: 

= FULL 2 = RENAME 4 = UPDATE 6 = EXECUTE 

1= REMOVE 3 = WRITE 5 = READ 7 = NO ACCESS 
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DIR + 1 

Contains various file flags and the month field of the packed date of last 
modification. 

Bit 7— Set to "1" if the file was "CREATEd" (see CREATE library com- 
mand in the Disk System Owner's Manual). Since the CREATE 
command can reference a file that is currently existing but non- 
CREATEd, it can turn a non-CREATEd file into a CREATEd one. 
You can achieve the same effect by changing this bit to a "1:' 

Bit 6— If set to "1," the file has not been backed up since its last modifica- 
tion. The BACKUP utility is the only TRSDOS facility that resets 
this flag. It is set during the close operation if the File Control Block 
(FCB + 0, Bit 2) shows a modification of file data. 

Bit 5— If set to "1," indicates a file in an open condition with UPDATE 
access or greater. 

Bit 4 — If the file was modified during a session where the system date was 
not maintained, this bit is set to "1." This specifies that the packed 
date of modification (if any) stored in the next three fields is not the 
actual date the modification occurred. If this bit is "1," the directory 
command displays plus signs ( + ) between the date fields if you 
request the (A) option. 

Bits 0-3— Contain the binary month of the last modification date, if this 
field is a zero, DATE was not set when the file was established or 
since if it was updated. 

DIR + 2 

Contains the remaining date of modification fields. 

Bits 3-7— Contain the binary day of last modification. 

Bits 0-2— Contain the binary year minus 80. For example, 1980 is coded 
as 000, 1981 as 001, 1982 as 010, and so on. 

DIR + 3 

Contains the end-of-file offset byte. This byte and the ending record number 
(ERN) form a pointer to the byte position that follows the last byte written. This 
assumes that programmers, interfacing in machine language, properly main- 
tain the next record number (NRN) offset pointer when the file is closed. 

DIR + 4 

Contains the logical record length (LRL) specified when the file was generated 
or when it was later changed with a CLONE parameter. 

DIR + 5 through DIR + 12 

Contain the name field of the filespec. The filename is left justified and padded 
with trailing blanks. 

DIR + 13 through DIR + 15 

Contain the extension field of the filespec. It is left justified and padded with 
trailing blanks. 

DIR + 16 and DIR + 17 

Contain the OWNER password hash code. 

DIR + 18 and DIR + 19 

Contain the USER password hash code. The protection level in DIR +0 is asso- 
ciated with this password. 
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DIR + 20 and DIR + 21 

Contain the ending record number (ERN), which is based on full sectors. If the 
ERN is zero, it indicates that no writing has taken place (or that the file was not 
closed properly). If the LRL is not 256, the ERN represents the sector where the 
EOF occurs. You should use ERN minus 1 to account for a value relative to sec- 
tor of the file. 

DIR + 22andDIR + 23 

This is the first extent field. Its contents indicate which cylinder stores the first 
granule of the extent, which relative granule it is, and how many contiguous 
grans are in use in the extent. 

DIR + 22— Contains the cylinder value for the starting gran of that extent. 

DIR + 23, Bits 5-7— Contain the number of the granule in the cylinder indi- 
cated by DIR + 22 which is the first granule of the file for that 
extent. This value is relative to zero ("0" denotes the first gran, 
"1" denotes the second, and so on). 

DIR + 23, Bits 0-4 — Contain the number of contiguous granules, relative 
to ("0" denotes one gran, "1" denotes two, and so on). Since 
the field is five bits, it contains a maximum of X'1 F or 31, which 
represents 32 contiguous grans. 

DIR + 24 and DIR + 25 

Contain the fields for the second extent. The format is identical to that for 
Extent 1. 

DIR + 26 and DIR + 27 

Contain the fields for the third extent. The format is identical to that for Extent 1. 

DIR + 28andDIR + 29 

Contain the fields for the fourth extent. The format is identical to that for 
Extent 1. 

DIR + 30 

This is a flag noting whether or not a link exists to an extended directory record. 
If no further directory records are linked, the byte contains X'FF A value of X'FE' 
in this byte establishes a link to an extended directory entry. (See "Extended 
Directory Records" below.) 

DIR + 31 

This is the link to the extended directory entry noted by the previous byte. The 
link code is the Directory Entry Code (DEC) of the extended directory record. 
The DEC is actually the position of the Hash Index Table byte mapped to the 
directory record. For more information, see the section "Hash Index Table." 

Extended Directory Records 

Extended directory records (FXDE) have the same format as primary directory 
records, except that only Bytes 0, 1, and 21-31 are utilized. Within Byte 0, only 
Bits 4 and 7 are significant. Byte 1 contains the DEC of the directory record of 
which this is an extension. An extended directory record may point to yet 
another directory record, so a file may contain an "unlimited" number of extents 
(limited only by the total number of directory records available). 



Granule Allocation Table (GAT) 



The Granule Allocation Table (GAT) contains information on the free and 
assigned space on the disk. The GAT also contains data about the formatting 
used on the disk. 
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A disk is divided into cylinders (tracks) and sectors. Each cylinder has a spec- 
ified number of sectors. A group of sectors is allocated whenever additional 
space is needed. This group is called a granule. The number of sectors per 
granule depends on the total number of sectors available on a logical drive. The 
GAT provides for a maximum of eight granules per cylinder. 

In the GAT bytes, each bit set to "1" indicates a corresponding granule in use 
(or locked out). Each bit reset to "0" indicates a granule free to be used. In a 
GAT byte, bit corresponds to the first relative granule, bit 1 to the second rel- 
ative granule, bit 2 the third, and so on. A 5 1 /4" single density diskette is format- 
ted at 10 sectors per cylinder, 5 sectors per granule, 2 granules per cylinder. 
Thus, that configuration uses only bits and 1 of the GAT byte. The remainder 
of the GAT byte contains all 1's, denoting unavailable granules. Other formatting 
conventions are as follows: 





Sectors 


Sectors 


Granules 


Maximum 




per 


per 


per 


No. of 




Cylinder 


Granule 


Cylinder 


Cylinders 


5" SDEN 


10 


5 


2 


80 


5" DDEN 


18 


6 


3 


80 


8" SDEN 


16 


8 


2 


77 


8" DDEN 


30 


10 


3 


77 


5-MEG HARD* 


32 


16 


8 


153 



*Hard drive format depends on the drive size and type, as well as the user's divi- 
sion of the drive into logical drives. These values assume that one physical 
hard disk is treated as one logical drive. 

The above table is valid for single-sided disks. TRSDOS supports double-sided 
operation if the hardware interfacing the physical drives to the CPU allows it. A 
two-headed drive functions as a single logical drive, with the second side as a 
cylinder-for-cylinder extension of the first side. A bit in the Drive Code Table 
(DCT + 4, Bit 5) indicates one-sided or two-sided drive configuration. 

A Winchester-type hard disk can be divided by heads into multiple logical 
drives. Details are supplied with Radio Shack drives. 

The Granule Allocation Table is the first relative sector of the directory cylinder. 
The following information describes the layout and contents of the GAT. 

GAT + X'00' through GAT + X'5F' 

Contains the free/assigned table information. GAT + corresponds to cylinder 
0, GAT + 1 corresponds to cylinder 1, GAT + 2 corresponds to cylinder 2, and so 
on. As noted above, bit of each byte corresponds to the first granule on the 
cylinder, bit 1 to the second granule, and so on. A value of "1" indicates the 
granule is not available for use. 

GAT + X'60' through GAT + X'BF 

Contains the available/locked out table information. It corresponds cylinder for 
cylinder in the same way as the free/assigned table. It is used during mirror- 
image backups to determine if the destination diskette has the proper capacity 
to effect a backup of the source diskette. This table does not exist for hard 
disks; for this reason, mirror-image backups cannot be performed on hard disk. 

GAT + X'C0' through GAT + X'CA' 

Used in hard drive configurations; extends the free/assigned table from X'00' 
through X'CA.Hard drive capacity up to 203 (0-202) logical or 406 physical cyl- 
inders is supported. 

GAT + X'CB' 

Contains the operating system version that was used in formatting the disk. For 
example, disks formatted under TRSDOS 6.1 have a value of X'6f contained in 
this byte. It is used to determine whether or not the disk contains all of the 
parameters needed for TRSDOS operation. 
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GAT + X'CC 

Contains the number of cylinders in excess of 35. It is used to minimize the time 
required to compute the highest numbered cylinder formatted on the disk. It is 
excess 35 to provide compatibility with alien systems not maintaining this byte. 
If you have a disk that was formatted on an alien system for other than 35 cyl- 
inders, this byte can be automatically configured by using the REPAIR utility. 
(See the section on the REPAIR utility in the Disk System Owner's Manual.) 

GAT + X'CD' 

Contains data about the formatting of the disk. 

Bit 7— If set to "1," the disk is a data disk. If "0," the disk is a system disk. 

Bit 6 — If set to "1," indicates double-density formatting. If "0," indicates 
single-density formatting. 

Bit 5 — If set to "1," indicates 2-sided disk. If "0," indicates 1-sided disk. 

Bits 3-4 — Reserved. 

Bits 0-2 — Contain the number of granules per cylinder minus 1. 

GAT + X'CE' and GAT + X'CF 

Contain the 16-bit hash code of the disk master password. The code is stored 
in standard low-order, high-order format. 

GAT + XW through GAT + X'D7' 

Contain the disk name. This is the name displayed during a FREE or DIR oper- 
ation. The disk name is assigned during formatting or during an ATTRIB disk 
renaming operation. The name is left justified and padded with blanks. 

GAT + X'D8' through GAT + X'DF' 

Contain the date that the diskette was formatted or the date that it was used as 
the destination in a mirror image backup operation in the format mm/dd/yy. 

GAT + X'E0' through GAT + X'FF 

Reserved for system use. 



The Hash Index Table is the key to addressing any file in the directory. It pin- 
points the location of a file's directory with a minimum of disk accesses, keeping 
overhead low and providing rapid file access. 

The system's procedure is to construct an 11-byte filename/extension field. The 
filename is left-justified and padded with blanks. The file extension is then 
inserted and padded with blanks; it occupies the three least significant bytes of 
the 11-byte field. This field is processed through a hashing algorithm which pro- 
duces a single byte value in the range X'01' through X'FF (A hash value of X'00' 
indicates a spare HIT position.) 

The system then stores the hash code in the Hash Index Table (HIT) at a posi- 
tion corresponding to the directory record that contains the file's directory. Since 
more than one 11-byte string can hash to identical codes, the opportunity for 
"collisions" exists. For this reason, the search algorithm scans the HIT for a 
matching code entry, reads the directory record corresponding to the matching 
HIT position, and compares the filename/extension stored in the directory with 
that provided in the file specification. If both match, the directory has been 
found. If the two fields do not match, the HIT entry was a collision and the algo- 
rithm continues its search from the next HIT entry. 

The position of the HIT entry in the hash table is called the Directory Entry Code 
(DEC) of the file. All files have at least one DEC. Files that are extended beyond 
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four extents have a DEC for each extended directory entry and use more than 
one filename slot. To maximize the number of file slots available, you should 
keep your files below five extents where possible. 

Each HIT entry is mapped to the directory sectors by the DEC's position in the 
HIT Think of the HIT as eight rows of 32-byte fields. Each row is mapped to one 
of the directory records in a directory sector: The first HIT row is mapped to the 
first directory record, the second HIT row to the second directory record, and so 
on. Each column of the HIT field (0-31 ) is mapped to a directory sector. The first 
column is mapped to the first directory sector in the directory cylinder (not 
including the GAT and HIT). Therefore, the first column corresponds to sector 
2, the second column to sector 3, and so on. The maximum number of HIT col- 
umns used depends on the disk formatting according to the formula: 
N = number of sectors per cylinder minus two, up to 32. 

The following chart shows the correlation of the Hash Index Table to the direc- 
tory records. Each byte value shown represents the position in the HIT. This 
position value is the DEC. The actual contents of each byte is either a X(00) 
indicating a spare slot, or the 1-byte hash code of the file that occupies the cor- 
responding directory record. 

Columns 

Row1 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 
10 11 12 13 14 15 16 17 18 19 1A 1B 1C 1D 1E 1F 

Row 2 20 21 22 23 24 25 26 27 28 29 2A 2B 2C 2D 2E 2F 
30 31 32 33 34 35 36 37 38 39 3A 3B 3C 3D 3E 3F 

Row 3 40 41 42 43 44 45 46 47 48 49 4A 4B 4C 4D 4E 4F 
50 51 52 53 54 55 56 57 58 59 5A 5B 5C 5D 5E 5F 

Row 4 60 61 62 63 64 65 66 67 68 69 6A 6B 6C 6D 6E 6F 
70 71 72 73 74 75 76 77 78 79 7A 7B 7C 7D 7E 7F 

Row 5 80 81 82 83 84 85 86 87 88 89 8A 8B 8C 8D 8E 8F 
90 91 92 93 94 95 96 97 98 99 9A 9B 9C 9D 9E 9F 

Row 6 A0 A1 A2 A3 A4 A5 A6 A7 A8 A9 AA AB AC AD AE AF 
B0 B1 B2 B3 B4 B5 B6 B7 B8 B9 BA BB BC BD BE BF 

Row 7 C0 C1 C2 C3 C4 C5 C6 C7 C8 C9 CA CB CC CD CE CF 
D0 D1 D2 D3 D4 D5 D6 D7 D8 D9 DA DB DC DD DE DF 

Row 8 E0 E1 E2 E3 E4 E5 E6 E7 E8 E9 EA EB EC ED EE EF 
F0 F1 F2 F3 F4 F5 F6 F7 F8 F9 FA FB FC FD FE FF 

A 5 1 /4" single density disk has 1 sectors per cylinder, two of which are reserved 
for the GAT and HIT. Since only eight directory sectors are possible, only the 
first eight positions of each HIT row are used. Other formats use more columns 
of the HIT, depending on the number of sectors per cylinder in the formatting 
scheme. 

The eight directory records for sector 2 of the directory cylinder correspond to 
assignments in HIT positions 00, 20, 40, 60, 80, A0, C0, and E0. On system 
disks, the following positions are reserved for system overlays. On data disks, 
these positions (except for 00 and 01) are available to the user. 

00 — BOOT/SYS 20 — SYS6/SYS 

01 — DIR/SYS 21 — SYS7/SYS 

02 — SYS0/SYS 22 — SYS8/SYS 

03 — SYS1 /SYS 23 — SYS9/SYS 

04 — SYS2/SYS 24 — SYS1 0/SYS 

05 — SYS3/SYS 25 — SYS1 1 /SYS 

06 — SYS4/SYS 26 — SYS1 2/SYS 

07 — SYS5/SYS 27 — SYS1 3/SYS 

These entry positions correspond to the first two rows of each directory sector 
for the first eight directory sectors. Since the operating system accesses these 
overlays by position in the HIT rather than by filename, these positions are 
reserved on system disks. 

The design of the Hash Index Table limits the number of files on any one drive 
to a maximum of 256. 
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Locating a Directory Record 

Because of the coding scheme used on the entries in the HIT table, you can 
locate a directory record with only a few instructions. The instructions are: 



ADD 
and 



AND 1FH 
,2 



AND 0E0H 



(calculates the sector) 



(calculates the offset in that sector) 



For example, if you have a Directory Entry Code (DEC) of X'84',the following 
occurs when these instructions are performed: 



AND 1FH 
ADD A .2 



Value of accumulator 
A = X'84' 

A = X'04' 



A = X'06' 

The record is in the seventh 

sector of the directory cylinder 

(0-6) 

Using the Directory Entry Code (DEC) again, you can find the offset into the 
sector that was found using the above instructions by executing one 
instruction: 



AND 0E0H 



Value of accumulator 
A = X'84' 

A = X'80' 

The directory record is X'80' (128) 
bytes from the beginning of 
the sector 

If the record containing the sector is loaded on a 256-byte boundary (LSB of the 
address is X'00') and HL points to the starting address of the sector, then you 
can use the above value to calculate the actual address of the directory record 
by executing the instruction: 

LD L.A 

When executed after the calculation of the offset, this causes HL to point to the 
record. For example: 

A = X'80' 

LD HL.4200H ;Where sector is loaded 
LD L , A ; Replace LSB with offset 

HL now contains 4280H, which is the address of the directory record you 
wanted. 

If you cannot place the sector on a 256-byte boundary, then you can use the 
following instructions: 

A = X'80' 

LD HL ,425GH ;Where sector is loaded 
LD e.A ;Put offset in E (LSB) 

LD D»0 ;Put a zero in D (MSB) 

ADD HL » DE ;Add two values together 

HL now contains 42D6H, which is the address of the directory record. 
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Note that the first DEC found with a matching hash code may be the file's 
extended directory entry (FXDE). Therefore, if you are going to write system 
code to deal with this directory scheme, you must properly deal with the FPDE/ 
FXDE entries. See Directory Records for more information. 



203 



6/Flle Contro 



File Control Block (FCB) 



The File Control Block (FCB) is a 32-byte memory area. Before the file is 
opened, this space holds the file's filespec. After an ©OPEN or @INIT super- 
visor call is performed, the system uses this area to interface with the file, and 
replaces the filespec with other information. When the file is closed, the filespec 
(without any specified password) is returned to the FCB. 

While a file is open, the contents of the FCB are dynamic. As records are written 
to or read from the disk file, specific fields in the FCB are modified. Avoid chang- 
ing the contents of the FCB during the time a file is open, unless you are sure 
that the change will not affect the integrity of the file. 

During most system access of the FCB, the IX index register is used to refer- 
ence each field of data. Register pair DE is used mainly for the initial reference 
to the FCB address. The information contained in each field of the FCB is as 
follows: 

FCB + 

Contains the TYPE code of the control block. 

Bit 7— If set to "1," indicates that the file is in an open condition; if "0," the 
file is assumed closed. This bit can be tested to determine the 
"open" or "closed" status of an FCB. 

Bit 6— Is set to "1" if the file was opened with UPDATE access or higher. 

Bit 5— Indicates a Partition Data Set (PDS) type file. 

Bits 4-3— Reserved for future use. 

Bit 2— Is set to "1" if the system performed any WRITE operation on this 
file. It is used to update the MOD flag in the directory record when 
the file is closed. 

Bits 1-0 — Reserved for future use. 

FCB + 1 

Contains status flag bits used in read/write operations by the system. 

Bit 7— If set to "V; indicates that I/O operations will be either full sector 
operations or byte operations of logical record length (LRL) less 
than 256. If "0," only sector operations will be performed. If you are 
going to use only full-sector I/O, you can reduce system overhead 
by specifying the LRL at open time as (indicating 256). An LRL 
of other than 256 sets bit 7 to "1" on open. 

Bit 6— If set to "1," indicates that the end of file (EOF) is to be set to ending 
record number (ERN) only if next record number (NRN) exceeds 
the current value of EOF. This is the case if random access is to be 
used. During random access, the EOF is not disturbed unless you 
extend the file beyond the last record slot. Any time the position 
routine (@POSN) is called, bit 6 is automatically set. If bit 6 is "0," 
then EOF will be updated on every WRITE operation. 

Bit 5— If "0," then the disk I/O buffer contains the current sector denoted 
by NRN. If set to "1," then the buffer does not contain the current 
sector. During byte I/O, bit 5 is set when the last byte of the sector 
is read. A sector read resets the bit, showing the buffer to be 
current. 
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Bit 4 — If set to "1," indicates that the buffer contents have been changed 
since the buffer was read from the file. It is used by the system to 
determine whether the buffer must be written back to the file before 
reading another record. If "0," then the buffer contents were not 
changed. 

Bit 3 — Used to specify that the directory record is to be updated each time 
the NRN exceeds the EOF. (The normal operation is to update the 
directory only when an FCB is closed.) Some unattended opera- 
tions may use this extra measure of file protection. It is specified by 
adding an exclamation mark ("!") to the end of a filespec when the 
filespec is requested at open time. 

Bits 2-0— Contain the user (access) protection level as retrieved from the 
directory of the file. The 3-bit binary value is one of the following: 

= FULL 2 = RENAME 4 = UPDATE 6 = EXECUTE 
1= REMOVE 3 = WRITE 5 = READ 7 = NO ACCESS 

FCB + 2 

Used by Partition Data Set (PDS) files. 

FCB + 3andFCB + 4 

Contain the buffer address in low-order, high-order format. This is the buffer 
address specified in register pair HL when the @INIT or @OPEN SVC is 
performed. 

FCB + 5 

Contains the relative byte offset within the current buffer for the next I/O oper- 
ation. If this byte has a zero value, then FCB + 1, Bit 5 must be examined to see 
if the first byte in the current buffer is the target position or if it is the first byte of 
the next record. If you are performing sector I/O of byte data (that is, maintain- 
ing your own buffering), then it is important to maintain this byte when you close 
the file if the true end of file is not at a sector boundary. 

FCB + 6 

Bits 3-7 — Reserved for system use. 

Bits 0-2 — Contain the logical drive number in binary of the drive contain- 
ing the file. Do not modify this byte; altering this value may damage 
other files. This byte and FCB + 7 are the only links to the file's 
directory information. 

FCB + 7 

Contains the directory entry code (DEC) for the file. This code is the offset in the 
Hash Index Table where the hash code for the file appears. Do not modify this 
byte; altering this value may damage other files. This byte and FCB + 6 are the 
only links to the directory information for the file. 

FCB + 8 

Contains the end-of-file byte offset. This byte is similar to FCB + 5 except that it 
pertains to the end of file rather than to the next record number. 

FCB + 9 

Contains the logical record length that was in effect when the file was opened. 
This may not be the same LRL that exists in the directory. The directory LRL is 
generated at the file creation and never changes unless the file is overwritten. 

FCB + 10ancf FCB + 11 

Contain the next record number (NRN), which is a pointer for the next I/O oper- 
ation. When a file is opened, NRN is zero, indicating a pointer to the beginning. 
Each sequential sector I/O advances NRN by one. 
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FCB + 12andFCB + 13 

Contain the ending record number (ERN) of the file. This is a pointer to the sec- 
tor that contains the end-of-file indicator. In a null file (one with no records), 
ERN equals 0. If one sector has been written, ERN equals 1. 

FCB + 14 and FCB + 15 

Contain the same information as the first extent of the directory. This represents 
the starting cylinder of the file (FCB + 14) and the starting relative granule within 
the starting cylinder (FCB + 15). FCB + 15 also contains the number of contig- 
uous granules allocated in the extent. These bytes are used as a pointer to the 
beginning of the file referenced by the FCB. 

FCB + 16 through FCB + 19 

This 4-byte entry contains granule allocation information for an extent of the file. 
Relative bytes and 1 contain the total number of granules allocated to the file 
up to but not including the extent referenced by this field. Relative byte 2 con- 
tains the starting cylinder of this extent. Relative byte 3 contains the starting rel- 
ative granule for the extent and the number of contiguous granules. 

FCB + 20 through FCB + 23 

Contain information similar to the above but for a second extent of the file. 

FCB + 24 through FCB + 27 

Contain information similar to the above but for a third extent of the file. 

FCB + 28 through FCB + 31 

Contain information similar to the above but for a fourth extent of the file. 

The file control block contains information on only four extents at one time. If 
the file has more than four extents, additional directory accessing is done to 
shift the 4-byte entries in order to make space for the new extent information. 

Although the system can handle a file of any number of extents, you should 
keep the number of extents small. The most efficient file is one with a single 
extent. The number of extents can be reduced by copying the file to a disk that 
contains a large amount of free space. 
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Proqramming Guidelines 



Conwerting to TRSDOS Version 6 



This section provides suggestions on writing programs effectively with 
TRSDOS Version 6, and on converting programs created with TRSDOS 1.3 
and LDOS 51 operating systems for use with TRSDOS Version 6. This infor- 
mation is by no means complete, but presents some important concepts to 
keep in mind when using TRSDOS Version 6. 

When programming in assembly language, you can use TRSDOS Version i 6 
routines for commonly used operations. These are accessed through the 
supervisor calls (SVCs) instead of absolute call addresses. Nothing in the sys- 
tem can be accessed via any absolute address reference (except Z-80 RST 
and NMI jump vectors). 

IMPORTANT NOTE: TRSDOS provides all functions and storage through 
supervisor calls. No address or entry point below 3000H is documented or sup- 
ported by Radio Shack. 

The keyboard is not accessible via "peeking;' and the video RAM cannot be 
"poked." The keyboard and video are accessible only through the appropriate 
SVCs. 

Another distinction is that TRSDOS Version 6 handling of logical byte I/O 
devices (keyboard, video, printer, communications line) completely supports 
error status feedback. A FLAG convention is uniform throughout these device 
drivers as well as physical byte I/O associated with files. The device handling 
in TRSDOS Version 6 is completely independent. That means that byte I/O, 
both logical and physical, can be routed, filtered, and linked. Therefore, it is 
important to test status return codes in all applications using byte I/O regard- 
less of the device that the application expects to be used, since re-direction to 
some other device is possible at the TRSDOS level. Appropriate action must be 
taken when errors are detected. 

Modules loaded into memory and protected by lowering HIGH$ must include 
the standard header, as described earlier under "Memory Header." The 
@GTMOD supervisor call requires that this header be present in every resident 
module for proper operation. 

The file password protection terms of UPDATE and ACCESS have been 
changed in TRSDOS Version 6 to OWNER and USER, respectively. The addi- 
tional file protection level of UPDATE has been added. A file with UPDATE pro- 
tection level can be read or written to, but its end of file cannot be extended. 
This protection can be useful in a random access fixed-size file or in a file where 
shared access is to take place. 

Files opened with UPDATE or greater access are indicated as open in their 
directory. Attempting to open the file again forces a change to READ access 
protection and a "File already open" error code. It is therefore important for 
applications to CLOSE files that are opened. 

For the convenience of applications that access files only for reading, you can 
inhibit the "file open bit." If you set bit of the system flag SFLAG$ (see the 
©FLAGS supervisor call), the file open bit is not set in the file's directory. Once 
set the next ©OPEN or @INIT SVC automatically resets bit of SFLAG$. 
Note that you cannot use this procedure for files being written to, since it inhibits 
the CLOSE process. 
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Some application programs need access to certain system parameters and 
variables. A number of flags, variables, and port images can be accessed rel- 
ative to a flag pointer obtained via the ©FLAGS supervisor call. These param- 
eters are only accessible relative to this pointer, as the pointer's location may 
change. (See the explanation of the ©FLAGS SVC.) 

All applications must honor the contents of HIGH$. This pointer contains the 
highest RAM address usable by any program. You can retrieve and change 
HIGH$ by using the @HIGH$ SVC. 

TRSDOS Version 6 library commands and utilities supply a return code (RC) at 
completion. The RC is returned in register pair HL. The value returned is either 
zero (indicating no error), a number from one through 62 (indicating an error as 
noted in Appendix A, TRSDOS Error Messages), or X'FFFF' (indicating an 
extended error which is currently not assigned an error number). TRSDOS Ver- 
sion 6 Job Control Language (JCL) aborts on any program terminating with a 
non-zero RC value. Applications should therefore properly set the return code 
register pair HL before exiting. 

TRSDOS Version 6 library commands are also invokable via the ©CMNDR 
SVC which executes the command. Library commands properly maintain the 
Stack Pointer (SP) and exit via a RET instruction. In this manner, control is 
returned to the invoking program with the RC present for testing. For com- 
mands invoked with the ©CMNDI SVC or prompted for via the ©EXIT SVC, 
the SP is restored to the system stack. The top of the stack will contain an 
address suitable for simulating an ©EXIT SVC; thus, if your application pro- 
gram properly maintains the integrity of the stack pointer, it can exit after setting 
the RC via a RET instruction instead of an ©EXIT SVC. 

TRSDOS Version 6 diskette and file structure is identical to that used in LDOS 
5.1. This includes formatting, directory structure, and data address mark con- 
ventions. TRSDOS Version 6 system diskettes, however, use the entire BOOT 
track (track 0). This compatibility means that data files may be used inter- 
changeably between LDOS 5.1 equipped machines and TRSDOS Version 6 
equipped machines; the diskettes themselves are readable and writable across 
both operating systems. 

The methods of internal handling of device linking and filtering have been 
changed from LDOS 5.1. (It is beyond the scope of this manual to explain the 
internal functioning of TRSDOS Version 6.) Device filters must adhere to a strict 
protocol of linkage in order to function properly. See the section on "Device 
Driver and Filter Templates" for information on device driver and filter protocol. 

Stack Handling Restrictions* 

Interrupt tasks and filters that deal with the keyboard or video must not place 
the stack pointer above X'F3FF.' This is because any operation that requires the 
keyboard or video RAM switches in the 3K bank at X'F400' and suppresses the 
stack until it is switched out again, if the system accesses the stack at any time 
during this period, the integrity of the stack is destroyed. 



*ln TRSDOS 6.0.0, the stack cannot be placed above X'F3FF' for any reason. 
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Programming With Restart Vectors 



The Restart instruction (RST) provides the assembly language programmer 
with the ability to call a subroutine with a one-byte call. If a routine is called 
many times by a program, the amount of space that is saved by using the RST 
instruction (instead of a three-byte CALL) can be significant. 

In TRSDOS a RST instruction is also used to interface to the operating system. 
The system uses RST 28H for supervisor calls. RSTS 00H, 30H, and 38H are 
for the system's internal use. 

RSTs 08H, 10H, 18H, and 20H are available for your use. Caution: Some pro- 
grams, such as BASIC, may use some of these RSTs. 

Each RST instruction calls the address given in the operand field of the instruc- 
tion. For example, RST 18H causes the system to push the current program 
counter address onto the stack and then set the program counter to address 
0018H. RST 20H causes a jump to location 0020H, and so on. 

Each RST has three bytes reserved for the subroutine to use. If the subroutine 
will not fit in three bytes, then you should code a jump instruction (JP) to where 
the subroutine is located. At the end of the subroutine, code a return instruction 
(RET). Control is then transferred to the instruction that follows the RST. 

For example, suppose you want to use RST 18H to call a subroutine named 
"ROUTINE." The following routine loads the restart vector with a jump instruc- 
tion and saves the old contents of the restart vector for later use. 



SETRST: 



LOOP: 



RDATAi 



LD 
LD 
LD 
LD 

LD 

LD 

LD 

INC 

INC 

DJNZ 
RET 
DEFB 
DEFW 



IX>0018H 
IY.RDATA 
B»3 

A , ( I X ) 

Ct (IY) 

(IX) »C 

(IY) .A 

IX 

IY 

LOOP 

0C3H 
ROUTINE 



Restart 
Data are 
Number o 
Read a b 
restart 
Read a b 
area 

Store th 
restart 
Store th 
area 

I n c r e m e n 
pointer 
I n c r e in e n 
pointer 
Loop til 
Return w 
Jump ins 
Ope rand 
subrouti 



Before exiting the program, calling the above routine 
contents of the restart vector back in place. 



area address 

a address 

f bvtes to move 

v t e from 

area 

y t e from data 

is byte i n 

area 

is b/te in data 

t restart area 

t data area 

1 3 bytes moved 

h e n d o n e 

t r u c t i o n ( J P ) 

(name of 

ne ) 

again puts the original 



KFLAG$ (MEM) . (PAUSE, and CENTER) 
Interfacing 



KFLAG$ contains three bits associated with the keyboard functions of BREAK, 
PAUSE f fSHlFT) (©), and ENTER. A task processor interrupt routine (called the 
KFLAG$ scanner) examines the physical keyboard and sets the appropriate 
KFLAG$ bit if any of the conditions are observed. Similarly, the RS-232C driver 
routine also sets the KFLAG$ bits if it detects the matching conditions being 
received. 
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Many applications need to detect a PAUSE or BREAK while they are running, 
BASIC checks for these conditions after each logical statement is executed 
(that is, at the en d of a line or at a ":"). That is how, in BASIC, you can stop a 
program with the (break) key or pause a listing. 

One method of detecting the condition in previous TRSDOS operating systems 
was to issue the @KBD supervisor call to check for BREAK or PAUSE 
( (SHIFT) (@)), ignoring all other keys. Unfortunately, this caused keyboard type- 
ahead to be ineffective; the @KBD SVC flushed out the type-ahead buffer if 
any other keystrokes were stacked up. 

Another method was to scan the keyboard, physically examining the keyboard 
matrix. An undesirable side effect of this method was that type-ahead stored up 
the keyboard depression for some future unexpected input request. Examining 
the keyboard directly also inhibits remote terminals from passing the BREAK or 
PAUSE condition. 

In TRSDOS Version 6, the KFLAG$ scanner examines the keyboard for the 
BREAK, PAUSE, and ENTER functions. If any of these conditions are detected, 
appropriate bits in the KFLAG$ are set (bits 0, 1, and 2 respectively). 

Note that the KFLAG$ scanner only sets the bits. It does not reset them 
because the "events" would occur too fast for your program to detect. Think of 
the KFLAG$ bits as a latch. Once a condition is detected (latched), it remains 
latched until something examines the latch and resets it — a function to be per- 
formed by your KFI_AG$ detection routine. 

For illustration, the following example routine uses the BREAK and PAUSE 
conditions: 



KFLAG$ 


EQU 


10 


@FLAGS 


EOU 


101 


@KBD 


EOU 


8 


@KEY 


EOU 


1 


0PAUSE 


EOU 


IB 


CKPANS 


LD 


A.0FLAGS 




RST 


28H 




LD 


At (IY+KFLAG$) 




RRCA 






JP 


C tGOTBRK 




RRCA 






RET 


IMC 




CALL 


RESKFL 




PUSH 


DE 


FLUSH 


LD 


A»@KBD 




RST 


28H 




JR 


Z»FLUSH 




POP 


DE 


PROMPT 


PUSH 


DE 




LD 


At§KEY 




RST 


28H 




POP 


DE 




CP 


80H 




JP 


Z»GOTBRK 




CP 


G0H 




JR 


Z (PROMPT 


RESKFL 


PUSH 


HL 




PUSH 


AF 




LD 


A >@FLAGS 




RST 


28H 


RESKFL1 


LD 


A»(IY+KFLAG$) 




AND 


0F8H 




LD 


(IY+KFLAG*) »A 




PUSH 


BC 




LD 


B»1G 



3 G e t F 1 a 3 s pointer 
5 i n t o register I Y 
iGet the KFLAG* 
SBit to carry 
5Go on BREAK 
5Bit 1 to carry 
3 Re turn if no pause 
IReset the flaS 

SFlush type -ahead 
5 b u f f e r while 
SiSnorinsf errors 



I W a i t on Key e n t r y 



5 Abort on (BREAK) 

i I Snore PAUSE 5 
seise . . , 
jreset KFLAG$ 

3 G e t f 1 a 3 s pointer 
3 into register IY 
SGet the flaS 
5Strip ENTER* 
5 PAUSE. BREAK 
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LD 

RST 

POP 

LD 

AND 

JR 

POP 

POP 

RET 

The best way to explain 
discuss each subroutine. 



A.0PAUSE 

28H 

BC 

A.(IY+KFLAG$> 

3 

NZ.RESKFL1 

AF 

HL 



! P a u s e a while 



SChecK if finSer is 
5 s t i 1 1 on Key 
5Reset it a 3 a i n 
iRestore registers 
iand exit 



this KFLAG$ detection routine is to take it apart and 
The first piece reads the KFLAG$ contents: 



KFLAG$ 
CKPAWS 



EOU 

LD 

RST 

LD 

RRCA 

JP 

RRCA 

RET 



10 

A.0FLAGS 

28H 

A.dY + KFLAG*) 

C .GOTBRK 

NC 



iGet F 1 a 3 s pointer 
i i n t o register I Y 
iGet the KFLAG$ 
5 Bit to carry 
5 Go on BREAK 
i B i t 1 to carry 
iRetum if no pause 



The ©FLAGS SVC obtains the flags pointer from TRSDOS. Note that if your 
application uses the IY index register, you should save and restore it within the 
CKPAWS routine. (Alternatively, you could use ©FLAGS to calculate the loca- 
tion of KFLAG$, use register HL instead of IY, and place the address into the LD 
instructions of CKPAWS at the beginning of your application.) 

The first rotate instruction places the BREAK bit into the carry flag. Thus, if a 
BREAK condition is in effect, the subroutine branches to "GOTBRK," which is 
your BREAK handling routine. 

If there is no BREAK condition, the second rotate places what was originally in 
the PAUSE bit into the carry flag. If no PAUSE condition is in effect, the routine 
returns to the caller. 

This sequence of code gives a higher priority to BREAK (that is, if both BREAK 
and PAUSE conditions are pending, the BREAK condition has precedence). 
Note that the GOTBRK routine needs to clear the KFLAG$ bits after it services 
the BREAK condition. This is easily done via a call to RESKFL. 

The next part of the routine is executed on a PAUSE condition: 



FLUSH 



CALL 


RESKFL 


PUSH 


DE 


LD 


A.0KBD 


RST 


2BH 


JR 


Z .FLUSH 


POP 


DE 



iReset the flasf 

5Flush type-ahead 
5 b u f f e r while 
5i Snorinsf errors 



First the KFLAG$ bits are reset via the call to RESKFL. Next, the routine takes 
care of the possibility that type-ahead is active. If it is, the PAUSE key was prob- 
ably detected by the type-ahead routine and so is stacked in the type-ahead 
buffer also. To flush out (remove all stored characters from) the type-ahead 
buffer, ©KBD is called until no characters remain (an NZ is returned). 

Now that a PAUSEd state exists and the type-ahead buffer is cleared, the rou- 
tine waits for a key input: 



5 W a i t on Key entry 



PROMPT 


PUSH 


DE 




LD 


A»@KEY 




RST 


28H 




POP 


DE 




CP 


80H 




JP 


Z .GOTBRK 




CP 


G0H 




JR 


Z .PROMPT 



SAbort on (BREAK) 

5 1 Snore PAUSE! 
Seise . . . 
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The PROMPT routine accepts a BREAK and branches to your BREAK han- 
dling routine. It ignores repeated PAUSE (the 60H). Any other character causes 
it to fall through to the following routine which clears the KFLAG$: 



RESKFL PUSH HL 

PUSH AF 

LD A,@FLAGS 

RST 28H 

RESKFL 1 LD A > ( IY+KFLAG* ) 

AND 0F8H 

LD (IY+KFLAG$) »A 

PUSH BC 

LD BtlG 

LD A»1PAUSE 

RST 2SH 

POP BC 

LD A»(IY+KFLAG$) 

AND 3 

JR NZ.RESKFL1 

POP AF 

POP HL 

RET 



i reset KFLAG* 

5Get f 1 a £f s pointer 
3 i n t o register I Y 
5Get the f I a sf 
SStrip ENTER* 
? PAUSE , BREAK 



> P a u s e a while 



5Check if finder is 
3 s t i 1 1 on key 
SReset it a 3 a i n 
SResto re registers 
5 and exit 



The RESKFL subroutine should be called when you first enter your application. 
This is necessary to clear the flag bits that were probably in a "set" condition. 
This "primes" the detection. The routine should also be called once a BREAK, 
PAUSE, or ENTER condition is detected and handled. (You need to deal with 
the flag bits for only the conditions you are using.) 



Interfacing to @ICNFG 



With the TRSDOS library command SYSGEN, many users may wish to SYS- 
GEN the RS-232C driver. Before doing that, the RS-232C hardware (UART, 
Baud Rate Generator, etc.) must be initialized. Simply using the SYSGEN com- 
mand with the RS-232C driver resident is not enough; some initialization 
routine is necessary. The @ICNFG (Initialization CoNFiGuration) vector is 
included in TRSDOS to provide a way to invoke a routine to initialize the RS- 
232C driver when the system is booted. It also provides a way to initialize the 
hard disk controller at power-up (required by the Radio Shack hard disk 
system). 

The final stages of the booting process loads the configuration file CONFIG/ 
SYS if it exists. After the configuration file is loaded, an initialization subroutine 
CALLs the @ICNFG vector. Thus, any initialization routine that is part of a 
memory configuration can be invoked by chaining into @ICNFG. 

If you need to configure your own routine that requires initialization at power-up, 
you can chain into @ICNFG. The following procedure illustrates this link. The 
first thing to do is to move the contents of the @ICNFG vector into your initiali- 
zation routine: 

5 G e t f 1 a 3 s pointer 
5 i n t o register I Y 
iGet opcode 

5Get address LOW 
iGet address HIGH 

This subroutine does this by transferring the 3-byte vector to your routine. You 
then need to relocate your routine to its execution memory address. Once this 
is done, transfer the relocated initialization entry point to the @ICNFG vector as 
a jump instruction: 



LD 


A»@FLAGS 


RST 


28H 


LD 


A »(IY + 28) 


LD 


(LINK) »A 


LD 


L»(IY+23) 


LD 


H.UY+30) 


LD 


(LINK+1) »HL 
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LD HLtlNIT SGet (relocated) 

LD (IY + 29)»L Hnit address 

LD (IY+30) »H 

LD A»0C3H SSet JP instruction 

LD (IY+28) >A 

If you need to invoke the initialization routine at this point, then you can use: 

CALL ROUTINE S Invoke your routine 

Your initialization routine would be unique to the function it was to perform, but 
an overall design would look like this: 

INIT CALL ROUTINE 5 St art of in it 
LINK DEFB 3 i Continue on 

ROUTINE • 

your initialization routine 

RET 

After linking in your routine, perform the SYSGEN. If you have followed these 
procedures, your routine will be invoked every time you start up TRSDOS. 



Interfacing to @KITSK 



Background tasks can be invoked in one of two ways. For tasks that do not 
require disk I/O, you can use the RTC (Real Time Clock) interrupt and one of 
the 12 task slots (or other external interrupt). For tasks that require disk I/O, you 
can use the keyboard task process. 

At the beginning of the TRSDOS keyboard driver is a call to @KITSK. This 
means that any time that @KBD is called, the @KITSK vector is also called. 
(The type-ahead task, however, bypasses this entry so that @KITSK is not 
called from the type-ahead routine.) Therefore, if you want to interface a back- 
ground routine that does disk I/O, you must chain into @KITSK. 

The interfacing procedure to @KITSK is identical to that shown in the section 
"Interfacing to @ICNFG," except that IY + 31 through IY + 33 is used to refer- 
ence the @KITSK vector. You may want to start your background routine with: 

START CALL ROUTINE 5 Invoke task 
LINK DEFS 3 iFor @KITSK hook 

ROUTINE EOU $ JStart of the task 

Be aware of one major pitfall. The @KBD routine is invoked from @CMNDI and 
@CMNDR (which is in SYS1/SYS). This invocation is from the @KEYIN call, 
which fetches the next command line after issuing the "TRSDOS Ready" mes- 
sage. If your background task executes and opens or closes a file (or does any- 
thing to cause the execution of a system overlay other than SYS1), then SYS1 
is overwritten by SYS2 or SYS3. When your routine finishes, the @KEYIN han- 
dler tries to return to what called it— SYS1, which is no longer resident. There- 
fore, any task chained to @KITSK which causes a resident SYS1 to be over- 
written must reload SYS1 before returning. 

You can use the following code to reload SYS1 if SYS1 was resident prior to 
your task's execution: 

ROUTINE LD A .iFLAGS 5Get flag's pointer 

RST 28H 5 into register IY 

LD A»(IY-1) SGet resident over- 

AND 8FH 'lay and remove 

LD (OLDSYS+l)tA ithe entry code 

rest of your task 
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EXIT 


EQU 


$ 


OLDSYS 


LD 


A»0 




CP 


83H 




RET 


NZ 




RST 


28H 



5Get old ouerlay » 
SWas it SYS1? 
5 Re turn if not 5 else 
5Get SYS1 per re3, A 
I (no RET needed) 



Interfacing 



This section explains how to integrate interrupt tasks into your applications. 

One of the hardware interrupts in the TRS-80 is the real time clock (RTC). The 
RTC is synchronized to the AC line frequency and pulses at 60 pulses per sec- 
ond, or once every 16.67 milliseconds. (Computers operating with 50 Hz AC 
use a 50 pulses per second RTC interrupt. In this case, all time relationships 
discussed in this section should be adjusted to the 50 Hz base.) 

A software task processor manages the RTC interrupt in performing back- 
ground tasks necessary to specific functions of TRSDOS (such as the time 
clock, blinking cursor, and so on). The task processor allows up to 12 individual 
tasks to be performed on a "time-sharing" basis. 

These tasks are assigned to "task slots" numbered from to 11. Slots 0-7 are 
considered "low priority" tasks (executing every 266.67 milliseconds). Slots 8- 
10 are medium priority tasks (executing every 33.33 milliseconds). Slot 11 is a 
high priority task (executing every 16.66 milliseconds SYSTEM (FAST) or 33 33 
milliseconds SYSTEM (SLOW)). Task slots 3, 7, 9, and 10 are reserved by the 
system for the ALIVE, TRACE, SPOOL, and TYPE-AHEAD functions, 
respectively. 

TRSDOS maintains a Task Control Block Vector Table (TCBVT) which contains 
12 vectors, one for each of the 12 task slots. TRSDOS contains five supervisor 
calls that manage the task vectors. The five SVCs and their functions are: 



@CKTSK 

@ADTSK 

@RMTSK 

@KLTSK 

@RPTSK 



Checks to see whether a task slot is unused or active 
Adds a task to the TCBVT 
Removes a task from the TCBVT 
Removes the currently executing task 
Replaces the TCB address for the current task 



The TRSDOS Task Control Block Vector Table contains vector pointers. Each 
TCBVT vector points to an address in memory, which in turn contains the 
address of the task. Thus, the tasks themselves are indirectly addressed. 

When you are programming a task to be called by the task processor, the entry 
point of the routine needs to be stored in memory. If you make this storage loca- 
tion the beginning of a Task Control Block (TCB), the reason for indirect vector- 
ing of interrupt tasks will become more clear. Consider an example TCB: 



MYTCB 


DEFW 


MYTASK 


COUNTER 


DEFF3 


15 


TEMPY 


DEFS 


1 


MYTASK 


RET 





This is a useless task, since the only thing it does is return from the interrupt. 
However, note that a TCB location has been defined as "MYTCB" and that this 
location contains the address of the task. A few more data bytes immediately 
following the task address storage have also been defined. 

Upon entry to a service routine, index register IX contains the address of the 
TCB. You can therefore address any TCB data using index instructions. For 
example, you could use the instruction "DEC (IX + 2)" to decrement the value 
contained in COUNTER in the above routine. 
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Here is the routine expanded slightly: 



MYTCB 


DEFW 


MYTASK 


COUNTER 


DEFB 


15 


TEMPY 


DEFB 





MYTASK 


DEC 


(IX+2) 




RET 


NZ 




LD 


( IX+2) 




RET 





■ 15 



This version makes use of the counter. Each time the task executes, the counter 
is decremented. When the count reaches zero, the counter is restored to its 
original value. 

In order to be executed, all tasks must be added to the TCBVT. The @ADTSK 
supervisor call does this. For the above routine, assume the task slot chosen is 
low-priority slot 2. You can ascertain that slot 2 is available for use by using the 
@CKTSK SVC as follows: 

SReference slot 2 
iSet for iCKTSK SMC 
5 An "NZ" indication 
> s a y s that the slot is 
3 b e i n 3 u s e d . 

Once you determine that the slot is available (that is, not being used by some 
other task), you can add your task routine. The following code adds this task to 
the TCBVT: 



LD 


C»2 


LD 


A ,28 


RST 


28H 


JP 


NZ»INUSE 



LD 
LD 
LD 
RST 



DE ,MYTCB 
C.2 
A»29 
28H 



» Point to the TCB 
SReference slot 2 
iSet for SADTSK SMC 
! Issue the SVC 



The above program lines point register DE to the TCB, load the task slot num- 
ber into register C, and then issue the @ADTSK supervisor call. If you want this 
task to run regardless of what is in memory, you can place it in high memory (of 
bank 0) and protect it by moving HIGH$ below it via the @HIGH$ supervisor 
call. 

Once a task has been activated, it is sometimes necessary to deactivate it. You 
can do this in two ways. The most common way is to use the @RMTSK super- 
visor call: 



LD 

LD 
RST 



A »30 
28H 



5Des i Snat e the tasK 

Sslot 

iSet for 0RMTSK SVC 

! Issue the SVC 



You identify the task slot to remove by placing a value in register C, and then 
you issue the supervisor call. 

You can use another method if you want to remove the task while it is being 
executed. Examine the routine modified as follows: 



MYTCB 


DEFW 


MYTASK 




COUNTER 


DEFB 


10 




TEMPY 


DEFB 







MYTASK 


DEC 


(IX+2) 






RET 


NZ 






LD 


A »32 


>Set for 0KLTSK 




RST 


28H 


5 Issue the SVC 



SVC 



The @KLTSK supervisor call removes the currently executing task from the 
TCBVT. The system does not return to your routine, but continues as if you had 
executed a RET instruction. For this reason, the @KLTSK SVC should be the 
last instruction you want executed. In this example, MYTASK decrements the 
counter by one on each entry to the task. When the counter reaches zero, the 
task is removed from slot 2. 
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The last task processor supervisor call is @RPTSK. The @RPTSK function 
updates the TCB storage vector (the vector address in your Task Control Block) 
to be the address immediately following the @RPTSK SVC instruction. As with 
@KLTSK, the system does not return to your service routine after the SVC is 
made, but continues on with the task processor. The following example illus- 
trates how @RPTSK can be used in a program: 



(3ADTSK 

SRPTSK 

@RMTSK 

@EXIT 

0VDCTL 

BEGIN 



TCB 

COUNTER 

TASKA 

TASK 



TASKB 



ORG 

EQU 

EQU 

EQU 

EQU 

EQU 

LD 

LD 

LD 

RST 

LD 

RST 

DEFW 

DEFB 

LD 

RST 

LD 

LD 

LD 

RST 

DEC 

RET 

LD 

LD 

RST 

LD 

LD 

LD 

RST 

DEC 

RET 

LD 

JR 

END 



9000H 

29 

31 

30 

22 

15 

DE »TCB 

C»0 

A .iADTSK 

2SH 

A»@EXIT 

2SH 

TASK 

15 

A»iRPTSK 

28H 

BC027CH 

HL,004FH 

A»@UDCTL 

28H 

( IX+2) 

NZ 

(IX+2) »15 

A»@RPTSK 

2SH 

BC022DH 

HL.004FH 

A»@MDCTL 

28H 

(IX+2) 

NZ 

(IX+2) ,15 

TASKA 

BEGIN 



5 Point to TCB 
Sand add the task 
Sto slot 



5Exit to TRSDOS 



3 R e p 1 a c e current 
5 task with TASKA 
S P u t a character 
Sat Row 0» Col. 79 



5 Dec re ment the counter 
Sand return if not 
5 expi red 5 else reset 
SReplace the previous 
itask with TASKB 
SPut a character 
Sat Row 0> Col, 79 



This task routine contains no method of relocating it to protected RAM. The 
statements starting at the label BEGIN add the task to TCBVT slot and return 
to TRSDOS Ready. The task contains a four-second down counter and a rou- 
tine to put a character in video RAM (80th character of Row 0). At four-second 
intervals, the character toggles between 'j' and ' - : This is done by using the 
@RPTSK SVC to toggle the execution of two separate routines which perform 
the character display. 

TRSDOS uses bank-switched memory. In order to properly control and man- 
age this additional memory, certain restrictions are placed on tasks. All tasks 
must be placed either in low memory (addresses X'0000' through X7FFF') or 
in bank zero of high memory (addresses X'8000' through X'FFFF'). The task 
processor always enables bank zero when performing background tasks. The 
assembly language programmer must ensure that tasks are placed in the cor- 
rect memory area. 



Interfacing RAM Banks 1 and 2 



The proper use of the RAM bank transfer techniques described here requires a 
high degree of skill in assembly language programming. This section on bank 
switching is intended for the professional. 
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The TRS-80 Model 4 can optionally support a second set of 64K RAM, bringing 
the total RAM to 128K. TRSDOS designates this extra 64K RAM as two banks 
of 32K RAM each, which are banks 1 and 2 of bank-switched RAM. The upper 
32K of standard RAM is designated bank 0. At any one time, only one of the 
banks is resident. The resident bank is always addressed at X'8000' through 
X'FFFR' When a bank transfer is performed, the specified bank becomes 
addressable and the previous bank is no longer available. Since memory 
refresh is performed on all banks at all times, nothing in the previously resident 
bank is altered during whatever time it is not addressable (that is, not resident). 

You can access this additional RAM by means of the @BANK supervisor call 
(SVC 102). When you power up your computer or press reset, TRSDOS looks 
to see which banks of RAM are installed in your machine. TRSDOS maintains 
a bit map in one byte of storage, with each bit representing one of the banks of 
RAM. This byte is called "Bank Available RAM" (BAR), and its information is set 
when you boot TRSDOS. Bit corresponds to bank 0, bit 1 corresponds to 
bank 1, and so on up to bit 7. From a hardware standpoint, the Model 4 has a 
maximum of three banks. You have either bank only (a 64K machine), or 
banks 0-2 (a 128K machine). 

Another bit map is used to indicate whether a bank is reserved or available for 
use. This byte is called the "Bank Used RAM" (BUR). Again, bit corresponds 
to bank 0, bit 1 to bank 1, and so on. TRSDOS design supports the use of banks 
1 and 2 primarily for data storage (for example, a spool buffer, Memdisk, etc.). 
The management of any memory space within a particular bank of RAM 
(excluding bank 0) is the responsibility of the application program "reserving" a 
particular bank. 

TRSDOS requires that any device driver or filter that is relocated to high mem- 
ory (X'8000' through X'FFFF') reside in bank 0. The TRSDOS device handler 
always invokes bank upon execution of any byte I/O service request (@PUT, 
@GET, @CTL, as well as other byte I/O SVCs that use @PUT/@GET/@CTL). 
This ensures that any filter or driver attached to the device in question will be 
available. If a RAM bank other than was resident, it is restored upon return 
from the device handler. This ensures that device I/O is never impacted by bank 
switching. 

TRSDOS also requires that all interrupt tasks reside in bank or low memory 
(X'0000' through X7FFF). The interrupt task processor always enables bank 
and restores whatever bank was previously resident. An interrupt task may per- 
form a bank transfer from to another bank provided the necessary linkage 
and stack area is used. This is discussed in more detail later. 

All bank transfer requests must be performed using the @BANK SVC. This 
SVC provides four functions, three of which are interrogatory and one of which 
performs the actual bank switching. 

As mentioned previously, the contents of banks other than are managed by 
the application, not by TRSDOS. Therefore, the application needs a way of find- 
ing out if any given bank is available. For example, if an application wants to 
reserve use of bank 1, it must first check to see if bank 1 is free to use. This is 
done by using function 2 as follows: 

SSpecify bank 1 

jCheck BUR if bank in use 

iSet SBANK BMC (102) 

5NZ if bank already in use 

Note that the return condition (NZ or Z) shows whether or not you can use the 
specified bank (it may not even be installed). 

If the specified bank is available, you then need to reserve it. Do this by using 
function 3 as follows: 



in use 



LD 


C tl 


LD 


B ,2 


LD 


A»@BANK 


RST 


28H 


JR 


NZtlNUSE 



LD 


C»l 


5 Specify bank 1 


LD 


B»3 


iSet BUR to show 
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LD A.iBANK 5Set 0BANK SMC (102) 

RST 28H 

JR NZ .ERROR 

You must check for an error by examining the Z flag. In general (discounting a 
system error), an NZ condition returned means that the specified bank is 
already in use. If you had performed a function 2 (testing to see if the bank was 
available) and got a not-in-use indication, but got an NZ condition on function 
3, then the @BANK SVC routine has been altered and is probably unusable. 

When an application no longer requires a memory bank, it can return the bank 
to a "free" state by using function 1 as follows: 

5 Specify banK 1 

5Set BUR to show free 

5 Set iBANK SMC (102) 

No error condition is checked, as none is returned by TRSDOS. If you should 
mistakenly use function 1 with a bank that is nonexistent, an error is returned if 
you try to invoke the nonexistent bank. 

To find out which bank is resident at any time, use function 4 as follows: 

SWhich bank is resident? 
SSet @BANK SMC (102) 



LD 


C.l 


LD 


B.l 


LD 


A.0BANK 


RST 


28H 



LD 


B.4 


LD 


A.iBANK 


RST 


28H 



The current bank number is returned in register A. 

To exchange the current bank with the specified bank, use function 0. Since a 
memory transfer takes place in the address range X'8000' through X'FFFF/ 
the transfer cannot proceed correctly if the stack pointer (SP) contains a value 
that places the stack in that range. @BANK inhibits function and returns an 
SVC error if the stack pointer violates this condition. 

A bank can be used purely as a data storage buffer. The application's routines 
for invoking and indexing the bank switching probably reside in the user range 
X'3000' through X7FFF' As an example, the following code invokes a previ- 
ously tested and reserved bank (via functions 2 and 3), accesses the buffer, 
and then restores the previous bank: 



LD 


C.i 


?Specify banK 1 


LD 


B.0 


SB riii 3 up bank 


LD 


A.0BANK 


iSet @BANK SMC (102) 


RST 


28H 




JR 


NZ .ERROR 


iErrar t rap 


PUSH 


BC 


5 Save old bank data 



your code to access the buffer region 

♦ 

POP BC SRecouer old bank data 

LD A.iBANK 5Set @BANK SMC (102) 

RST 28H 

JR NZ. ERROR 5Error trap 

Note that the @BANK function conveniently returns a zero in register B to 
effect a function later, as well as provides the old bank number in register C. 
This means that you only have to save register pair BC, pop it when you want 
to restore the previous bank, and then issue the @BANK SVC. 

Suppose you want to transfer to another bank from a routine that is executing 
in high memory. (Recall that the only limitation is that the stack must not be in 
high memory.) The @BANK SVC function provides a technique for automat- 
ically transferring to an address in the new bank. This technique is called the 
transfer function. It relies on the assumption that since you are managing the 
entire 32K bank 1 or 2, your application should know exactly where it needs to 
transfer (that is, where the application originally placed the code to execute). 
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The code to perform a bank transfer is similar to the above example. Register 
pair HL is loaded with the transfer address. Register C, which contains the num- 
ber of the bank to invoke, must have its high order bit (bit 7) set. After the spec- 
ified bank is enabled, control is passed to the transfer address that is in HL. 
Upon entry to your routine in the new bank (referred to here as "PROGB"), reg- 
ister HL will contain the old return address so that PROGB will know where to 
return transfer. Register C will also contain the old bank number with bit 7 set 
and register B will contain a zero. This register set-up provides for an easy 
return to the routine in the old bank that invoked the bank transfer. An illustra- 
tion of the transfer code follows: 

LD C 1 1 ! Specif y bank 1 

LD B »0 SBrinS up bank 

LD HLt(TRAADR) 5Set the transfer 

5 a d d r e s s 
BET 7>C 5 and denote a 

itransfer 
LD A»@BANK iSet 0BANK SMC (102) 
RST 28H 
RETADR JR N2 »ERROR 

Control is returned to "RETADR" under either of two conditions. If there was an 
error in executing the bank transfer (for example, if an invalid bank number was 
specified or the stack pointer is in high memory), the returned condition is NZ. 
If the transfer took place and PROGB transferred back, the returned condition 
is Z. Thus, the Z flag shows whether or not there was a problem with the 
transfer. 

If PROGB needs to provide a return code, it must be done by using register pair 
DE, IX, or IY, as registers AF, BC, and HL are used to perform the transfer. (Or, 
some other technique can be used, such as altering the return transfer address 
to a known error trapping routine.) 

PROGB should contain code that is similar to that shown earlier. For example, 
PROGB could be: 

PROGB 



PUSH 


BC 




?Sai.ie old bank dat 


PUSH 


HL 




5 Save the RET 
5 a d d r e s s 


y o u r 


PROGB ro 


u tines 




* 
POP 


HL 




5 Re cover transfer 
5 a d d r e s s 


POP 


BC 




5Get bank transfer 
5 d a t a 


LD 


A, 102 




iSet @BANK SVC 


RST 


28H 






JR 


NZ, ERROR 


5Er ro r t rap 



PROGB saves the bank data (register BC). Don't forget that a transfer was 
effected and register C has bit 7 already set when PROGB is entered. PROGB 
also saves the address it needs to transfer back (which is in HL). It then per- 
forms whatever routines it has been coded for, recovers the transfer data, and 
issues the bank transfer request. As explained earlier, an NZ return condition 
from the @BANK SVC indicates that the bank transfer was not performed. You 
should verify that your application has not violated the integrity of the stack 
where the transfer data was stored. 

Never place disk drivers, device drivers, device filters, or interrupt service rou- 
tines in banks other than bank 0. It is possible to segment one of the above 
modules and place segments in bank 1 or 2, provided the segment containing 
the primary entry is placed in bank 0. You can transfer between segments by 
using the bank transfer techniques discussed above. 
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Dewice Driwer and Filter Templates 



Device independence has its roots in "byte I/O." Byte I/O is any I/O passed 
through a device channel one byte at a time. 

Three primitive routines are available at the assembly language level for byte 
I/O. These byte I/O primitives can be used to build larger routines. The three 
primitives are the TRSDOS supervisor calls @GET, @PUT, and @CTL. @GET 
is used to input a byte from a device or file. @PUT is used to output a byte to a 
device or file. @CTL is used to communicate with the driver routine servicing 
the device or file. 

Other supervisor calls perform byte I/O, such as @KBD (scan the keyboard and 
return the key code if a key is down), @DSP (display a character on the video 
screen), and @PRT (output a character to the line printer). These functions 
operate by first loading register pair DE with a pointer to a specific Device Con- 
trol Block (DCB) assigned for use by the device, then issuing a @GET or 
@PUT SVC for input or output requests. 

When TRSDOS passes control over to the device driver routine, the Z-80 flag 
conditions are unique for each different primitive. This enables the driver to 
establish which primitive was used to access the routine, so it can turn over the 
I/O request to the proper driver or filter subroutine according to the type of 
request — input, output, or control. 

The following table shows the FLAG register conditions upon entry to a driver 
or filter: 

C,NZ =@GET primitive 
Z,NC =@PUT primitive 
NZ,NC = @CTL primitive 

Register B contains the I/O direction code: 1 =@GET, 2 = @PUT, 4 = @CTL 
Register C contains the character code that was passed in the @PUT or @CTL 
supervisor call. Register IX points to the TYPE byte (DCB + 0) of the Device 
Control Block. Registers BC, DE, HL, and IX have been saved on the stack and 
are available for use. Register AF is not saved; if you want it preserved, your 
program must do so. 

Your driver must start with a standard front-end header (see "Memory 
Header"): 

BEGIN JR START 5Go to actual code 

5 b e 3 i n n i n 3 
DEFN MODEND-1 5Last byte used by 

5 m o d u 1 e 
DEFB 7 JLenath of name 

DEFM 'MODNAME' 5 Name 
MODDCB DEFW $-$ 5DCB ptr. for this 

5 m o d u 1 e 
DEFW 5Reserued by TRSDOS 

At the start of the actual module code, test the condition of the F register flags 
for @GET, @PUT, and @CTL: 

START ECU $ 

5 Actual module code start 

JR CWASGET !Go if @GET request 

JR Z,WASPUT !Go if @PUT request 
• !Was iCTL request 

At the label START, a test is made on the carry flag. If the carry was set, then 
the disk primitive must have been an input request (@GET). An input request 
could be directed to a part of the driver which only handles input from the 
device. 
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If the request was not from the @GET primitive, the carry will not be set. The 
next test checks to see if the zero flag is set. The zero condition is preset when 
a @PUT primitive was the initial request. The jump to WASPUT can go to a part 
of the driver that deals specifically with output to the device. 

If neither the zero nor carry flags are set, the routine falls through to the next 
instruction (not shown), which would begin the part of the driver that handles 
@CTL calls. For example, you may want to have an RS-232C driver handle a 
BREAK by issuing a @CTL call so that the RS-232C driver emits a true modem 
break, but a CONTROL C would @PUT a X'03.' 

Some drivers are written to assume that @CTL requests are to be handled 
exactly like @PUT requests. This is entirely up to the author and the function of 
the driver. 

Note that when a device is routed to a disk file, TRSDOS ignores @CTL 
requests. That is, the @CTL codes are not written to the disk file. 

On @GET requests, the character input should be placed in the accumulator. 
On output requests (either @PUT or @CTL), the character is obtained from 
register C. It is important for drivers and filters to observe return codes. Specif- 
ically, if the request is @GET and no byte is available, the driver returns an NZ 
condition and the accumulator contains a zero (that is, OR 1 : LD A,0 : RET). If 
a byte is available, the byte is placed in the accumulator and the Z flag is set 
(that is, LD A,CHAR : CP A : RET). If there is an input error, the error code is 
returned in the accumulator and the Z flag is reset (that is, LD A.ERRNUM : OR 
A : RET). On output requests, the accumulator will contain the byte output with 
the Z flag set if no error occurred. In the case of an output error, the accumulator 
must be loaded with the error code and the Z flag reset as shown above. 

A filter module is inserted between the DCB and driver routine (or between the 
DCB and the current filter when it is applied to a DCB already filtered). The 
insertion is performed by the TRSDOS FILTER command once the filter mod- 
ule is resident and attached to a phantom DCB. The usual linkage for a filter is 
to access the chained module by calling the @CHNIO supervisor call with spe- 
cific linkage data in registers IX and BC. Register IX is loaded with the filter's 
DCB pointer obtained from the memory header MODDCB pointer. Register B 
must contain the I/O direction code (1 = @GET, 2 = @PUT, 4 = @CTL). This 
code is already in register B when the filter is entered. You can either keep reg- 
ister B undisturbed or load it with the proper direction code. Also, output 
requests expect the output byte to be in register C. 

The DCB pointer obtained from MODDCB is passed in register DE by the SET 
command and is loaded into MODDCB by your filter initialization routine. The 
initialization routine needs to relocate the filter to high memory and attach itself 
to the DCB assigned by the SET command. If the initialization front end had 
transferred the DCB pointer from DE to IX, then the following code could be 
used to establish the TYPE byte and vector for the filter: 

LD (IX)»47H Jlnit DCB type to 
LD (IX+1),E .FILTER f G/P/C I/O* 
LD (IX+2)»D 56 : stuff vector 

A filter module can operate on input, output, control, or any combination based 
on the author's design. The memory header provides a region for user data 
storage conveniently indexed by the module. 

An illustration of a filter follows. The purpose of this filter is to add a linefeed on 
output whenever a carriage return is to be sent. Although the filter requires no 
data storage, the technique for accessing data storage is shown. 
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BEGIN 



MODDCB 

5 

CR 

LF 

DATA* 

DATA1 

DATA2 



START 

5 

5 

5 

5 



FLTPUT 



RX01 



GOT PUT 
RX02 



RX03 



FLTEND 

5 

RELTAB 
TABLEN 



JR 

DEFW 

DEFB 

DEFM 

DEFW 

DEFW 

Data 

EQU 

EQU 

ECU 

EQU 

DEFB 

EQU 

DEFB 

Start 

JR 

@GET 

the n 

This 

to th 

f ilte 

so th 

with 

PUSH 

LD 

EQU 

LD 

RST 

POP 

RET 

Filte: 

LD 

EQU 

LD 

CP 

JR 

CALL 

EQU 

RET 

LD 

JR 

EQU 

Re 1 oc 

DEFW 

EQU 



START 
FLTEND-1 
S 

'SAMPLE' 


storage area f 
0DH 
0AH 
$ 
*-DATA$ 



$-DATA$ 


of filte'r 

Z.GOTPUT 
and SCTL reiue 
e x t module a 1 1 
is acconiplishe 
e SCHNIO call, 
r does not aff 
e filter does 
the direction 

IX 

IX .(MODDCB) 

$-2 

A. SCHNIO 

28H 

IX 

code 

IX »PFDATA$ 

$-2 

A.C 



SB ranch to start 
5 L a s t byte used 
5Name length 
IName 

ILinK to DCB 
5 R e s e r u e d 
or your filter 



IData storage 

!Data storage 

5Go if SPUT 
sts are chained to 
ached to the device* 
d by falling t h r o u 3 h 

Note that the sample 
ect the B register, 
not have to load it 
code. 

5 S a v e your data 

5 p o i n t e r 

? Grab the DCB vector 
5 and chain to it 



CR 

NZ, FLTPUT 

FLTPUT 
$-2 
NZ 

C.LF 
FLTPUT 
$ 
a t i o n table 

RX01 .RX02.RX03 
$-RELTAB/2 



•iBase register 
5 u s e d to index 
SGet cha ract e r 
5 test 
! If not CR i put 



1 s 

data 

to 

it 



Seise put it 

5 B a c k on error 
I A d d linefeed 



The relocation table, RELTAB, would be used by the filter initialization relocation 
routine. 



@€TL interfacing t© Dewlo© Dow 



This section discusses the @CTL functions supported by the system device 
drivers. To invoke a @CTL function, point register pair DE to the Device Control 
Block (DCB), load the function code into register C, and issue the @CTL super- 
visor call. You can locate the DCB address by either 1) using the @GTDCB 
SVC, or 2) using the ©OPEN SVC to open a File Control Block containing the 
device specification and using the FCB address. See the @CTL supervisor call 
for a list of the function codes and their meanings. 
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The @CTL functions are listed below for each driver. 

Keyboard Driver (resident driver assigned to *KI) 

A function value of X'03' clears the type-ahead buffer. This serves the same 
purpose as repeated calls to @KBD until no character is available. 

A function value of X'FF is reserved for system use. 

All other function values are treated as @GET requests. 

The module name assigned to this driver is "$K!" 

Video Driver (resident driver assigned to *DO) 

All @CTL requests are treated as if they were @PUT requests. 

The module name assigned to this driver is "$DO" 

Printer Driver (resident driver assigned to *PR) 

The printer driver is transparent to all code values when requested by the 
@PUT SVC. That means that all values from XW through X'FF (0-255) can 
be sent to the printer. If the FORMS filter is attached to the *PR device, then 
various codes are trapped and used by the filter according to parameters spec- 
ified with the FORMS library command, as follows: 

X'0D' —Generates a carriage return and optionally a linefeed (ADDLF). 

Generates form feeds as required. 
X'0A' —Treated the same way as X'0D.' 
X'0C —Generates form feeds (via repeated line feeds if soft form feed). 

(FFHARD = OFF) 
X'09' —Advances to next tab column. 
X'06' —Sets top-of-form by resetting the internal line counter to zero. 

Other character codes may be altered if the user translation option of the 
FORMS command (XLATE) is set. 

The printer driver accepts a function value of X'00' via the @CTL request to 
return the printer status. If the printer is available, the Z flag will be set and reg- 
ister A will contain X'30.' If the Z flag is reset, register A will contain the four high- 
order bits of the parallel printer port (bits 4-7). 

The module name assigned to the printer driver is "$PR'.' The module name of 
the FORMS filter is "$FF'.' 

COM Driver (non-resident driver for the RS-232C) 

This driver handles the interfacing between the RS-232C hardware and byte 
I/O (usually the *CL device). 

A @CTL function value of X'00' returns an image of the RS-232 status register 
in the accumulator. The Z flag will be set if the RS-232 is available for "sending" 
(that is, if the transmit holding register is empty and the flag conditions match 
as specified by SETCOM). 

A function value of X'0f transmits a "modem break" until the next character is 
@PUT to the driver. 

A function value of X'02' re-inmalizes the UART to the values last established 
by SETCOM. 

A function value of X'04' enables or disables the WAKEUP feature. 

All other function values are ignored and the driver returns with register A con- 
taining a zero value and the Z flag set. 

The WAKEUP feature is useful for application software specializing in com- 
munications. The RS-232 hardware can generate a machine interrupt under 
any of three conditions: when the transmit holding register is empty, when a 
received character is available, or when an error condition has been detected 
(framing error, parity error, and so on). The COM driver makes use of the 
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"received character available" interrupt to take control when a fully formed char- 
acter is in the holding register. The COM driver services the interrupt by reading 
the character and storing it in a one-character buffer. COM then normally 
returns from the interrupt. 

An application can request that, instead of returning, control be passed to the 
application for immediate attention. Note that this action would occur during 
interrupt handling, and any processing by the application must be kept to a min- 
imum before control is returned to COM via a RET instruction. 

If you use a @CTL function value of X'04,' then register IY must contain the 
address of the handling routine in your application. Upon return from the @CTL 
request, register IY contains the address of the previous WAKEUP vector. This 
should be restored when your application is finished with the WAKEUP feature. 

When control is passed to your WAKEUP vector upon detection of a "receive 
character available" interrupt, certain information is immediately available. Reg- 
ister A contains an image of the UART status register. The Z flag is set if a valid 
character is actually available. The character, if any, is in the C register. 

Since system overhead takes a small amount of time in the @GET supervisor 
call, you may need to @GETthe character via standard device interfacing. This 
ensures that any filtering or linking in the *CL device chain will be honored. If, 
on the other hand, your application is attempting to transfer data at a very high 
rate (9600 baud or higher), you may need to bypass the @GET SVC and use 
the character immediately available in the C register. Note that this procedure 
bypasses the normal device chain (device routing and linking). 

The module name of the COM driver is "$CL" 
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8/Usinq the Syperwisor Calls 



Supervisor Calls (SVCs) are operating system routines that are available to 
assembly language programs. These routines alter certain system functions 
and conditions, provide file access, and perform various computations. They 
also perform I/O to the keyboard, video display, and printer. 

Each SVC has a number which you specify to invoke it. These numbers range 
from to 1 04. 



Calling Procedure 



TocallaTRSDOSSVC: 

1 . Load the SVC number for the desired SVC into register A. Also load any 
other registers which are needed by the SVC, as detailed under Supervisor 
Calls. 

2. Execute a RST 28H instruction. 

Note: If the SVC number supplied in register A is invalid, the system prints the 
message "System Error xx',' where xx is usually 2B. It then returns you to 
TRSDOS Ready (not to the program that made the invalid SVC call). 

The alternate register set (AF," BC,' DE,' HL) is not used by the operating system. 



Program Entry and Return Conditions 



When a program executed from the ©CMNDI SVC is entered, the system 
return address is placed on the top of the stack. Register HL will point to the first 
non-blank character following the command name. Register BC will point to the 
first byte of the command line buffer. 

Three methods of return from a program back to the system are available: the 
©ABORT SVC, the ©EXIT SVC, and the RET instruction. For application pro- 
grams and utilities, the normal return method is the @EXIT SVC. If no error con- 
dition is to be passed back, the HL register pair must contain a zero value. Any 
non-zero value in HL causes an active JCL to abort. 

The ©ABORT SVC can be used as an error return back to the system; it auto- 
matically aborts any active JCL processing. This is done by loading the value 
X'FFFF' into the HL register pair and internally executing an ©EXIT SVC. 

If stack integrity is maintained, a RET instruction can be used since the system 
return address is put on the stack by ©CMNDI. This allows a return if the pro- 
gram was called with ©CMNDR. 

Most of the SVCs in TRSDOS Version 6 set the Z flag when the operation spec- 
ified was successful. When an operation fails or encounters an error, the Z flag 
is reset (also known as NZ flag set) and a TRSDOS error code is placed in the 
A register. The remaining SVCs use the Z/NZ flag in differing ways, so you 
should refer to the description of the SVCs you are using to determine the exit 
conditions. 
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Superwisor Calls 



The TRSDOS Supervisor Calls are: 




Keyboard SVCs 


Byte I/O SVCs 


@KBD 


©CTL 


@KEY 


©GET 


@KEYIN 


©PUT 


Printer and Video SVCs 


File Control SVCs 


@DSP 


©CLOSE 


@DSPLY 


©FEXT 


@LOGER 


©FNAME 


@LOGOT 


©FSPEC 


@MSG 


©INIT 


@PRT 


©REMOV 


©PRINT 


©OPEN 


@VDCTL 


©RENAM 


Disk SVCs 


Disk File Handier SVCs 


@DCINIT 


©BKSP 


@DCRES 


©CKEOF 


@DCSTAT 


©LOC 


@RDSEC 


©LOF 


@RDSSC 


©PEOF 


@RSLCT 


©POSN 


@RSTOR 


©READ 


©SEEK 


©REW 


@SLCT 


©RREAD 


@STEPI 


©RWRIT 


@VRSEC 


©SEEKSC 


@WRSEC 


©SKIP 


@WRSSC 


©VER 


@WRTRK 


©WEOF 




©WRITE 


System Control SVCs 


TRSDOS Task Control SVCs 


©ABORT 


©ADTSK 


©BREAK 


©CKTSK 


©CMNDI 


©KLTSK 


©CMNDR 


©RMTSK 


©EXIT 


©RPTSK 


©FLAGS 




@HIGH$ 




©IPL 




©LOAD 




©RUN 




Special Purpose Disk SVCs 


Special Overlay SVCs 


©DIRRD 


©CKDRV 


©DIRWR 


©DEBUG 


©GTDCT 


©DODIR 


©HDFMT 


©ERROR 


©RDHDR 


©PARAM 


©RDTRK 


©RAMDIR 
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Miscellaneous SVCs Special Purpose SVCs 

©BANK @CHNIO 

@DATE @GTDCB 

@DECHEX @GTMOD 

@DIV8 

@DIV16 

@HEXDEC 

@HEX8 

@HEX16 

@MUL8 

@MUL16 

©PAUSE 

©SOUND 

©TIME 

©WHERE 

See the pages that follow for a detailed description of each supervisor call 
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m)i 



Loads HL with an X'FFFF' error code and exits through the @EXIT supervisor 
call. Any active JCL processing is aborted. 

Entry Conditions: 

A = 21 (X'15') 
General: 

This SVC does not return. 
Example: 

See the example for @EXIT in Sample Program B, lines 206-207. 
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SVC Number 29 



Add an Interrupt Level Task 



Adds an interrupt level task to the real time clock task table. The task slot num- 
ber can be 0-11; however, some slots are already assigned to certain functions 
in TRSDOS. Slot assignments 0-7 are low priority tasks executing every 266.67 
milliseconds. Slots 8-10 are medium priority tasks executing every 33.33 milli- 
seconds. Slot 11 is a high priority task, executing every 16.66 milliseconds High 
Speed or 33.33 milliseconds Low Speed. The system uses task slots 3, 7, 9, 
and 10 for the ALIVE, TRACE, SPOOL, and TYPE-AHEAD functions, 
respectively. 

It is a good practice to remove an existing task (using the @RMTSK or 
@KLTSK SVC) before installing a new task in the same task slot. 

Entry Conditions: 

A =29(X'1D') 

DE = pointer to Task Control Block (TCB) 

C = task slot assignment (0-1 1 ) 

Exit Conditions: 

Success always. 

HL and AF are altered by this SVC. 

The Task Control Block, or TCB, is a 2-byte block of RAM which contains the 
address of the task driver entry point. If your task is prefixed with the memory 
header described earlier under "Device Access," then the TCB can be stored in 
the memory header data storage area. If the task is not a driver or filter, the TCB 
can be stored in the memory header location MODDCB. Upon entry to your 
task routine, the IX register contains the TCB address. 

Example: 

See Sample Program F, lines 109-120. 
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SVC Number 1 §2 



or¥ Bank Use 



Controls 32K memory bank operation. The top half of the main 64K block is 
bank 0, and the alternate 64K block is divided into banks 1 and 2. The system 
maintains two locations to perform bank management. These areas are known 
as "bank available RAM" (BAR) and "bank in use RAM" (BUR). 

If the Stack Pointer is not X7FFE' or lower, the SVC aborts with an Error 43 only 
if B = 0. 

Entry Conditions: 
A= 102(X*66') 
B selects one of the following functions: 

If B = 0, the specified bank is selected and is made addressable. 
The 32K bank starts at X'8000' and ends at X'FFFR 
C = bank number to be selected (0-2) 

If bit 7 is set, then execution will resume in the newly loaded 
bank at the address specified. 
HL = address to start execution in the new bank 
If B = 1, reset BUR and show the bank not in use. 

C = bank number to be selected (0-2) 
If B = 2, test BUR if bank is in use. 

C=bank number to be selected (0-2) 
If B = 3, set BUR to show bank in use. 

C = bank number to be selected (0-2) 
If B=4, return number of bank currently selected. 

Exit Conditions: 

If B = 0: 

Success, Z flag set. 
C = the bank number that was replaced. If bit 7 was set in register 

C on entry, it is also set on exit. 
HL = SVC return address. By keeping the contents of C and HL, 
you can later return to the instruction following the first 
©BANK SVC. See "Interfacing RAM Banks 1 and 2" for more 
information. 
Failure, NZ flag set. Bank not present or parameter error. 
A = error number 

If B = 1: 

Success, Z flag set. Bank available for use. 
Failure, NZ flag set. Bank not present. 

lfB = 2: 

Success always. 
If Z flag is set, then the bank is available for use. 
If NZ flag is set, then test register A: 

If A ± X'2B' then the bank is either in use or it does not exist on 
your machine. Banks 1 and 2 produce this error on a 64K 
machine. 
If A=X'2B' then an entry parameter is out of range. 

If B = 3: 

Success, Z flag set. Bank is now reserved for your use. 
Failure, NZ flag set. Test register A: 

If A + X'2B' then the bank is already in use or does not exist. Banks 
1 and 2 produce this error on a 64K machine. 

If A = X'2B,' then an entry parameter is out of range. 



232 



If B = 4: 

Success always. 
A = number of the bank which is currently resident 

General: 

AF is altered for all functions. 

BC is altered if the SVC is successful. 

Example: 

See the section "Interfacing RAM Banks 1 and 2." 
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0)1/ 



si <qb0 



Performs a backspace of one logical record. 

Entry Conditions: 
A =61 (X'3D') 
DE = pointer to FCB of the file to backspace 

Exit Conditions: 

If the Z flag is set or if A = X'1 C or X'1 D,' then the operation was successful. 
The LOC pointer to the file was backspaced one record. Otherwise, 
A = error number. 

If A = X'1 C is returned, the file pointer is positioned at the end of the file. 
Any Appending operations would be performed here. 
If A = X'1D' is returned, the file pointer is positioned beyond the end of 
the file. 

General: 

Only AF is altered by this SVC. 

If the LOC pointer was at record when the call was executed, the results 
are indeterminate. 

Example: 

See the example for @LOC in Sample Program C, lines 305-311. 
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SVC Number 103 



Set Break Vector 



Sets a user or system break vector. The BREAK vector is an abort mechanism; 
there is no return. 

The BREAK vector executes whenever the following conditions occur at the 
same time: 1 ) the Program Counter is greater than X'2400,' 2) the BREAK key 
is pressed, and 3) a real time clock interrupt which executes 30 times per sec- 
ond occurs. 

After executing this SVC, you must reset bit 4 of SFLAG$. The BREAK flag in 
KFLAG$ (bit 0) requires the setting of SFLAG$ bit 4 and a delay of 0.1 to 0.5 
second to clear any other interrupts that may be pending. Then you can enter 
your BREAK key handler (in which the BREAK key bit in SFLAG$ is reset). See 
KFLAG$ and SFLAG$ in the section about the ©FLAGS SVC for more 
information. 

Entry Conditions: 

A =103(X'67") 

HL = user break vector 

HL = (sets system break vector) 

Exit Conditions: 

Success always. 

HL = existing break vector (if user break vector was set) 

Note: @EXIT and @CMNDI automatically restore BREAK to the system han- 
dler. @CMNDR does not do this. 
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S¥C Number 20 



Pass Control to Next 



in Dewte Chain 



Passes control to the next module in the device chain. 

Entry Conditions: 
A =20(X'14') 

IX = contents of DCB in the header block 
B = GET/PUT/CTL direction code (1/2/4) 
C = character (if output request) 

General: 

IX is not checked for validity. 

Example: 

See the section "Device Driver and Filter Templates." 
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CKDRV SVC Number 33 



Check Drive 



Checks a drive reference to ensure that the drive is in the system and a 
TRSDOS Version 6 or LDOS 5.1.3 (Model III Hard Disk Operating System) for- 
matted disk is in place. 

Entry Conditions: 

A = 33(X'2f) 

C= logical drive number (0-7) 

Exit Conditions: 

Success always. 

If Z flag is set, the drive is ready. 

If CF is set, the disk is write protected. 
If NZ flag is set, the drive is not ready. The user may examine DCT + 
to see if the drive is disabled. 

Example: 

See Sample Program D, lines 35-55. 
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Check for End=©frFiIe 



Checks for the end of file at the current logical record number. 

Entry Conditions: 
A =62(X'3E") 
DE = pointer to the FCB of the file to check 

Exit Conditions: 
Success always. 

If Z flag is set, LOC does not point at the end of file (LOC < LOF). 
If NZ flag is set, test A for error number: 

If A = X'1 C LOC points at the end of the file (LOC = LOF). 

If A = X'1 D,' LOC points beyond the end of the file (LOC > LOF). 

If A ± X'1 C or X'1 D,' then A = error number. 

General: 

Only AF is altered by this SVC. 

Example: 

See the example for @LOC in Sample Program C, lines 300-311 and 352- 
353. (A substantial part of this code could be replaced with the 
@CKEOF SVC.) 
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CKTSK SVC Number 28 

Check if Task Slot in Use 

Checks to see if the specified task slot is in use. 

Entry Conditions: 

A = 28(X'1C) 

C = task slot to check (0-1 1 ) 

Exit Conditions: 

Success always. 

If Z flag is set, the task slot is available for use. 
If NZ flag is set, the task slot is already in use. 

General: 

AF and HL are altered by this SVC. 

Example: 

See Sample Program F, lines 70-73. 
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3L0SE S¥C Number 6© 

Close a File or Oewiee 

Terminates output to a file or device. Any unsaved data in the buffer area is 
saved to disk and the directory is updated. All files that have been written to 
must be closed, as well as all files opened with UPDATE or higher access. 

Entry Conditions: 
A =60(X'3C) 
DE = pointer to FCB or DCB to close 

Exit Conditions: 

Success, Z flag set. The file or device was closed. The filespec (excluding 

the password) or the devspec is returned to the FCB or DCB. 
Failure, NZ flag set. 
A= error number 

General: 

Only AF is altered by this SVC. 

Example: 

See Sample Program C, lines 355-363. 
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@CMND1 SVC Number 24 

Execute Command with Return to System 

Passes a command string to TRSDOS for execution. After execution is com- 
plete, control returns to TRSDOS Ready. If the command gets an error, it still 
returns to TRSDOS Ready. 

Entry Conditions: 

A =24(X'18') 

HL = pointer to buffer containing command string terminated with X'0D' 
(up to 80 bytes, including the X'0D') 

General: 

This SVC does not return. 

Example: 

See Sample Program E, lines 43-58. 
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SVC Number 25 



Execute Command 

Executes a command or program and returns to the calling program. The exe- 
cuted program should maintain the Stack Pointer and exit via a RET instruction. 
All TRSDOS library commands comply with this requirement. 

If bit 4 of CFLAG$ is set (see the ©FLAGS SVC), then @CMNDR executes 
only system library commands. 

Entry Conditions: 

A =25(X"19') 

HL=pointer to buffer containing command string terminated with X'0D' 
(up to 80 bytes, including the X'0D') 

Exit Conditions: 

Success always. 

HL = return code (See the section "Converting to TRSDOS Version 6" 

for information on return codes.) 
Registers AF, BC, DE, IX, and IY are altered by the command or pro- 
gram executed by this SVC. 
If the command invokes a user program which uses the alternate reg- 
isters, they are modified also. 

Example: 

See Sample Program E, lines 18-29. 
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CTL 

^Hfr ■ ■8HB 



SVC Number 5 



Output a Control Byte 



Outputs a control byte to a logical device. The DCB TYPE byte (DCB + 0, Bit 2) 
must permit CTL operation. See the section "@CTL Interfacing to Device Driv- 
ers" for information on which of the functions listed below are supported by the 
system device drivers. 

Entry Conditions: 

A =5(X'05') 

DE = pointer to DCB to control output 

C selects one of the following functions: 

If C = 0, the status of the specified device will be returned. 

If C = 1, the driver is requested to send a BREAK or force an interrupt. 

If C = 2, the initialization code of the driver is to be executed. 

If C = 3, all buffers in the driver are to be reset. This causes all pending 

I/O to be cleared. 
If c = 4, the wakeup vector for an interrupt-driven driver is specified by 
the caller. 

IY = address to vector when leaving driver. If IY = 0, then the 
wakeup vector function is disabled. 
If C = 8, the next character to be read will be returned. This allows data 
to be "previewed" before the actual @GET returns the character. 

Exit Conditions: 
If C = 0, 

Z flag set, device is ready 
NZ flag set, device is busy 

A = status image, if applicable 
Note: This is a hardware dependent image. 
lfC=1, 

Success, Z flag set. BREAK or interrupt generated. 
Failure, NZ flag set 

A= error number 
lfC = 2, 

Success, Z flag set. Driver initialized. 
Failure, NZ flag set 

A = error number 
If C = 3, 

Success, Z flag set. Buffers cleared. 
Failure, NZ flag set. 

A = error number 
If C = 4, 

Success, Z flag set. Wakeup vector set or disabled. 

IY = previous vector address 
Failure, NZ flag set 

A = error number 
If C = 8, 

Success, Z flag set. Next character returned. 

A = next character in buffer 
Failure, NZ flag set. Test register A: 

If A = 0, no pending character is in buffer 

If A=£0, A contains error number. (TRSDOS driver returns Error 43.) 
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General: 

BC, DE, HL, and IX are saved. 

Function codes 5 to 7, 9 to 31, and 255 are reserved for the system. Function codes 
32 to 254 are available for user definition. 

Entry and exit conditions for user-defined functions are up to the design of the user- 
supplied driver. 

Example: 

See the section "Device Driver and Filter Templates." 
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DATE SVC Number 18 



Get Date 



Returns today's date in display format (MM/DD/YY). 

Entry Conditions: 

A =18(X'12') 

HL = pointer to 8-byte buffer to receive date string 

Exit Conditions: 

Success always. 

HL = pointer to the end of the buffer supplied + 1 
DE= pointer to start of DATES storage area in TRSDOS 
BC is altered by this SVC. 

Example: 

See Sample Program F, lines 252-253. 
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DCINIT SVC Number 42 



Initialize the FDC 



Issues a disk controller initialization command. The floppy disk driver treats this 
the same as @RSTOR (SVC 44). 

Entry Conditions: 

A = 42(X'2A') 

C = logical drive number (0-7) 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A= error number 

Example: 

See the example for @CKDRV in Sample Program D, lines 38-39. 
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DCRES SVC Number 43 



Reset the FDC 



Issues a disk controller reset command. The floppy disk driver treats this the 
same as @RSTOR (SVC 44). 

Entry Conditions: 

A = 43(X'2B') 

C= logical drive number (0-7) 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A = error number 

Example: 

See the example for @CKDRV in Sample Program D, lines 38-39. 
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IT SVC Number 4# 



Test if Driwe Assigned in OCT 



Tests to determine whether a drive is defined in the Drive Code Table (DCT). 

Entry Conditions: 
A= 40(X'28') 
C= logical drive number (0-7) 

Exit Conditions: 
Success always. 

If Z is set, the specified drive is already defined in the DCT. 
If NZ is set, the specified drive is not defined in the DCT 

General: 

Only AF is altered by this SVC. 

Example: 

See Sample Program D, lines 27-33. 
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DEBUG SVC Number 27 



Enter DEBUG 



Forces the system to enter the DEBUG utility. Pressing © (ENTER] from the 
DEBUG monitor causes program execution to continue with the next instruc- 
tion. If you want to use the functions in the extended debugger when DEBUG 
is entered in this fashion, you must issue the DEBUG (E) command (optionally 
with the @CMNDR SVC) before this SVC is executed. 

Entry Conditions: 

A = 27(X'1B') 

General: 

This SVC does not return unless © is entered in DEBUG. 

Example: 

See Sample Program A, lines 54-60. 
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SVC Number 96 



Conwert Decimal ASCII to Binary 

Converts a decimal ASCII string to a 16-bit binary number. Overflow is not 
trapped. Conversion stops on the first out-of-range character. 

Entry Conditions: 

A =96(X'60") 

HL = pointer to decimal string 

Exit Conditions: 

Success always. 

BC = binary conversion of ASCII string 
HL = pointer to the terminating byte 
AF is altered by this SVC. 

Example: 

See Sample Program B, lines 88-95. 
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DIRRD SVC Number 87 



Directory Record Read 



Reads a directory sector that contains the directory entry for a specified Direc- 
tory Entry Code (DEC). The sector is placed in the system buffer and the reg- 
ister pair HL points to the first byte of the directory entry specified by the DEC. 

Entry Conditions: 

A = 87(X'57') 

B = Directory Entry Code of the file 

C= logical drive number (0-7) 

Exit Conditions: 

Success, Z flag set. 

HL = pointer to directory entry specified by register B 
Failure, NZ flag set. 

A = error number 

HL is altered. 

General: 

AF is always altered. 

If the drive does not contain a disk, this SVC may hang indefinitely waiting 

for formatted media to be placed in the drive. The programmer should 

perform a @CKDRV SVC before executing this call. 
If the Directory Entry Code is invalid, the SVC may not return or it may 

return with the Z flag set and HL pointing to a random address. Care 

should be taken to avoid using the wrong value for the DEC in this call. 

Example: 

See Sample Program C, lines 152-174. 
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SVC Number 88 



Directory Record Write 



Writes the system buffer back to the disk directory sector that contains the 
directory entry of the specified DEC. 

Entry Conditions: 
A = 88(X'58') 

B = Directory Entry Code of the file 
C= logical drive number (0-7) 

Exit Conditions: 

Success, Z flag set. 

HL = pointer to directory entry specified by register B 
Failure, NZ flag set. 

A = error number 

HL is altered. 

General: 

AF is always altered. 

If the drive does not contain a disk, this SVC may hang indefinitely waiting 

for formatted media to be placed in the drive. The programmer should 

perform a @CKDRV SVC before executing this call. 
If the Directory Entry Code is invalid, the SVC may not return or it may 

return with the Z flag set and HL pointing to a random address. Care 

should be taken to avoid using the wrong value for the DEC in this call. 

Example: 

See the example for @DIRRD in Sample Program C, lines 152-174. 
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DIV8 SVC Number 93 



8-Bit Divide 



Performs an 8-bit unsigned integer divide. 

Entry Conditions: 

A = 93(X'5D') 
E = dividend 
C= divisor 

Exit Conditions: 

Success always. 
A = quotient 
E = remainder 
No other registers are altered. 

Example: 

See Sample Program B, lines 61-64. 
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1V16 SVC Number 94 

16-Bit by 8-Bit Divide 

Performs a division of a 16-bit unsigned integer by an 8-bit unsigned integer. 

Entry Conditions: 
A =94(X'5E') 
HL = dividend 
C = divisor 

Exit Conditions: 

Success always. 
HL = quotient 
A = remainder 
No other registers are altered. 

Example: 

See Sample Program B, lines 105-109. 
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DODIR SVC Number 34 

Do Directory Display /Buffer 

Reads files from a disk directory or finds the free space on a disk. The directory 
information is either displayed on the screen (in five-across format) or sent to a 
buffer. The directory information buffer consists of 18 bytes per active, visible 
file: the first 16 bytes of the directory record, plus the ERN (ending record num- 
ber). An X'FF' marks the buffer end. 

Entry Conditions: 

A = 34(X J 22') 

C= logical drive number (0-7) 
B selects one of the following functions: 
If B = 0, the directory of the visible, non-system files on the disk in the 
specified drive is displayed on the screen. The filenames are dis- 
played in columns, 5 filenames per line, 
if B = 1, the directory is written to memory. 

HL = pointer to buffer to receive information 
If B = 2, a directory of the files on the specified drive is displayed for files 
that are visible, non-system, and match the extension partspec 
pointed to by HL. 
HL= partspec for the filename's extension 

This field must contain a valid 3-character extension, padded 
with dollar signs ($). For example, to display all visible, non- 
system files that have the letter 'C as the first character of the 
extension, HL should point to the string "C$$'.' 
If B = 3, a directory of the files on the specified drive is written to the buffer 
that is specified by HL for files that match the extension partspec 
pointed to by HL. 
HL = pointer to the 3-byte partspec and to the buffer to receive the 

directory records (see general notes) 
Keep in mind that the area pointed to by HL is shared. If you are 
using this buffer more than once, you have to re-create the 
partspec in the buffer before each call because the previous 
call will have erased the partspec by writing the directory 
records. 
If B = 4, the disk name, original free space, and current free space on the 
disk is read. 
HL = pointer to a 20-byte buffer to receive information 

Exit Conditions: 

Success, Z flag set. 

If B = 1 or 3, the directory records have been stored. 

HL = pointer to the beginning of the buffer 
if B = or 2, the filenames or matching filenames are displayed with 5 

filenames per line. 
If B = 4, the disk name and free space information are stored in the 
format: 
Bytes 0-7 = Disk name. Disk name is padded on the right 

with blanks (X'20'). 
Bytes 8-1 5 = Creation date (the date the disk was formatted 
or was the target disk in a mirror image 
backup). The date is in the format MM/DD/YY. 
Bytes 16-1 7 = Total K originally available in binary LSB-MSB 

format. 
Bytes 18-1 9 = Free K available now in binary LSB-MSB 
format. 
HL = pointer to the beginning of the data area 
Failure, NZ flag set. 
A = error number 
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General: 

AF is the only register altered by this SVC. 

The size of the buffer to receive directory records must be large enough to 
hold directory entries for the maximum number of files allowed on the 
drive and disk you specify. For example, if the drive is a hard disk, you 
must be able to store 256 directory entries, and each entry requires 18 
bytes of storage. For more information on calculating the amount of 
space needed for this buffer, see the tables under "Directory Records." 
They give the maximum number of entries allowed on a given type of 
disk. You must add 2 records to this value when B = 1 to store the direc- 
tory entry for DIR/SYS and BOOT/SYS. 

Example: 

See Sample Program E, lines 32-40. 
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DSP SVC Number 2 



Display Character 



Outputs a byte to the video display. The byte is displayed at the current cursor 
position. 

Entry Conditions: 

A = 2(X'02') 

C= byte to display 

Exit Conditions: 

Success, Z flag set. 

A= byte displayed 
Failure, NZ flag set. 

A= error number 

General: 

DE is altered by this SVC. 

Example: 

See Sample Program C, lines 219-221. 
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DSPLY 8VG Number 10 

Display Message Line 

Displays a message line, starting at the current cursor position. The line must 
be terminated with either a carriage return (X'0D') or an ETX (X'03'). If an ETX 
terminates the line, the cursor is positioned immediately after the last character 
displayed. 

Entry Conditions: 
A = 10(X'0A) 
HL = pointer to first byte of message 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A = error number 

General: 

AF and DE are altered by this SVC. 

Example: 

See Sample Program C, lines 35-37. 
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ERROR SVC Number 26 



Entry to Post an Error Message 



Provides an entry to post an error message. If bit 7 of register C is set, the error 
message is displayed and return is made to the calling program. If bit 6 is not 
set, the extended error message is displayed. 

*** Errcod=xx» Error message string *** 
<filespeo or d e y s p e c > 

Referenced at X ' d d d d ' 

If bit 6 is set, then only the "Error message string" is displayed. This bit is 
ignored if bit 6 of SFLAG$ (the extended error message bit) is set. If bit 6 of 
CFLAG$ is set, then no error message is displayed. If bit 7 of CFLAG$ is set, 
then the "Error message string" is placed in a user buffer pointed to by register 
pair DE. See ©FLAGS (SVC 101) for more information on SFLAG$ and 
CFLAG$. 

Entry Conditions: 

A = 26(X'1A') 

0= error number with bits 6 and 7 optionally set 

Exit Conditions: 

Success always. 

General: 

To avoid a looping condition that could result from the display device gen- 
erating an error, do not check for errors after returning from @ERROR. 

If you do not set bit 6 of register C, then you should execute this SVC only 
after an error has actually occurred. 

Example: 

See Sample Program C, lines 374-384. 
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IT SVC Number 22 



Exit to TRSDOS 



This is the normal program exit and return to TRSDOS. An error exit can be 
done by placing a non-zero value in HL. Values 1 to 62 indicate a primary error 
as described in TRSDOS Error Codes (Appendix A). (A non-zero value in HL 
causes an active JCL to abort.) 

Entry Conditions: 
A =22(X'16') 
HL = Return Code 

If HL =0, then no error on exit. 

If HL¥=0, then the ©ABORT SVC returns X'FFFF' in HL automatically. 

General: 

This SVC does not return. 

Example: 

See Sample Program B, lines 206-207. 
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FEXT SVC Number 79 



Set Up Default File Extension 



Inserts a default file extension into the File Control Block if the file specification 
entered contains no extension. @FEXT must be done before the file is opened. 

Entry Conditions: 

A =79(X'4F) 
DE= pointer to FCB 

HL = pointer to default extension (3 characters; alphabetic characters 
must be upper case and first character must be a letter) 

Exit Conditions: 

Success always. 

AF and BC are altered by this SVC. 

If the default extension is used, HL is also altered. 

Example: 

See Sample Program C, lines 111-132. 
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SVC Number 101 



>ystem Flag Table 



Points the IY register to the base of the system flag table. The status flags listed 
below can be referenced off IY. You can alter those bits marked with an asterisk 
(*). Bits without an asterisk are indicators of current conditions, or are unused 
or reserved. 

Note: You may wish to save KFLAG$ and SFLAG$ if you intend to modify them 
in your program, and restore them on exit. 

Entry Conditions: 

A=101 (X'65') 

Exit Conditions: 

Success always. 

IY= pointer to the following system information: 

IY - 1 Contains the overlay request number of the last system module 

resident in the system overlay region. 
IY + 2 =CFLAG$ 

* bit 7 — If set, then @ERROR will transfer the "Error message 

string" to your buffer instead of displaying it. The mes- 
sage is terminated with X'0D.' 

* bit 6 — If set, do not display system error messages 0-62. 

See ©ERROR (SVC 26) for more information. 

* bit 4 — If set, then @CMNDR will execute only system library 

commands, 
bit 3 — If set, @RUN is requested from either the SET or 

SYSTEM (DRIVER = ) commands, 
bit 2 — If set, @KEYIN is executing due to a request from 

SYS1. 
bit 1 — If set, @CMNDR is executing. This bit is reset by 

©EXIT and ©CMNDI. 

* bit — If set, HIGH$ cannot be changed using @HIGH$ 

(SVC 100). This bit is reset by ©EXIT and ©CMNDI. 
IY + 3 =DFLAG$ (device flag) 

* bit 7 — "1" if GRAPH IC printer capability desired on screen 

print ( (CONTROL) (T) causes screen print. See the SYS- 
TEM (GRAPHIC) command under "Technical Infor- 
mation on TRSDOS Commands and Utilities.") 

bit 6 — "1" if KSM module is resident 

bit 5 — Currently unused 

bit 4 — "1" if MemDisk active 

bit 3 — Reserved 

bit 2 — "1"if Disk Verify is enabled 

* bit 1 — "1" if TYPE-AHEAD is active 
bit — "1" if SPOOL is active 

IY + 5 =FEMSK$ (mask for port 0FEH) 
IY + 8 =IFLAG$ (international flag) 

* bit 7 — If "1," 7-bit printer filter is active 

If "0," normal 8-bit filters are present 

* bit 6 — If "1," international character translation will be per- 

formed by printer driver 

If "0," characters received by printer driver will be sent 

to the printer unchanged 
bit 5 — Reserved for future languages 
bit 4 — Reserved for future languages 
bit 3 — Reserved for future languages 
bit 2 — Reserved for future languages 
bit 1 — If "1," German version of TRSDOS is present 
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bit — If "1," French version of TRSDOS is present 
If bits 5-0 are all zero, then USA version of TRSDOS is present. 
I Y + 1 = KFLAG$ (keyboard flag) 

bit 7 — "1" if a character is present in the type-ahead buffer 
bit 6 — Currently unused 

* bit 5 — "1" if CAPS lock is set 
bit 4 — Currently unused 

bit 3 — Curre ntly un used 

* bit 2 — "1" if (ENTER) has been pressed 

* bit 1 -— "1" if (SHIFT) (D has been pressed (PAUSE) 

* bit — "1" if (BREAK) has been pressed 

Note: To use bits 0-2, you must first reset them and then test to 

see if they become set. 
IY + 1 2 = MODOUT (image of port 0ECH) 
IY + 1 4 = OPREG$ (memory management & video control image) 
IY+18 = SFLAG$ (system flag) 

bit 7 — "1" if DEBUG is to be turned on 

* bit 6 — "1" if extended error messages desired (see 

©ERROR for message format); overrides the setting 
of bit 6 of register C on ©ERROR (SVC 26) and 
should be used only when testing 
bit 5 — "1" if DO commands are being executed 

* bit 4 — "1" if BREAK disabled 

bit 3 — "1" if the hardware is running at 4 mhz (SYSTEM 
(FAST)). If "0," the hardware is running at 2 mhz (SYS- 
TEM (SLOW)). 

* bit 2 — "1" if LOAD called from RUN 

* bit 1 — "1" if running an EXECute only file 

* bit — "1" specifies no check for matching LRL on file open 

and do not set file open bit in directory. This bit should 
be set just before executing an @OPEN (SVC 59) if 
you want to force the opened file to be READ only dur- 
ing current I/O operations. As soon as either call is 
executed, SFLAG$ bit is reset. If you want to disable 
LRL checking on another file, you must set SFLAG$ 
bit again. 
IY + 21 =VFLAG$ 

bit 7 — Reserved for system use 

* bit 6 — "1" selects solid cursor, "0" selects blinking cursor 
bit 5 — Reserved for system use 

* bit 4 — "1" if real time clock is displayed on the screen 
bits 0-3 — Reserved for system use 

IY + 22 = WRINTMASK$ (mask for WRINTMASK port) 

IY + 26 = SVCTABPTR$ (pointer to the high order byte of the SVC table 

address; low order byte = 00) 
IY + 27 = Version ID byte (60H = TRSDOS version 6.0.x.x, 

61 H = TRSDOS version 6.1. x.x, etc.) 
IY- 47 = Operating system release number. Provides a third and fourth 

character (12H = TRSDOS version x.x.1.2) 
IY + 28 
to 

IY + 30 = @ICNFG vector 
IY + 31 
to 
IY + 33 = @KITSK vector 
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FNAME SVC Number 80 



Get Filename 



Gets the filename and extension from the directory using the specified Direc- 
tory Entry Code (DEC) for the file. 

Entry Conditions: 

A =80(X'50") 

DE= pointer to 15-byte buffer to receive filename/extension:drive, fol- 
lowed by a X'@D' as a terminator 
B = DEC of desired file 
C = logical drive number of drive containing file (0-7) 

Exit Conditions: 

Success, Z flag set. 

HL= pointer to directory entry specified by register B 
Failure, NZ flag set. 

A = error number 

HL is altered. 

General: 

AF and BC are always altered. 

If the drive does not contain a disk, this SVC may hang indefinitely waiting 

for formatted media to be placed in the drive. The programmer should 

perform a @CKDRV SVC before executing this call. 
If the Directory Entry Code is invalid, the SVC may not return or it may 

return with the Z flag set and HL pointing to a random address. Care 

should be taken to avoid using the wrong value for the DEC in this call. 

Example: 

See Sample Program C, lines 274-286. 
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FSPEC SVC Number 78 

Assign File or Device Specification 

Moves a file or device specification from an input buffer into a File Control Block 
(FCB). Conversion of lower case to upper case is made automatically. 

Entry Conditions: 

A =78(X'4E') 

HL= pointer to buffer containing filespec or devspec 

DE= pointer to 32-byte FCB or DCB 

Exit Conditions: 

Success always. 

If the Z flag is set, the file specification is valid. 

HL = pointer to terminating character 

DE= pointer to start of FCB 
If the NZ flag is set, a syntax error was found in the filespec. 

HL= pointer to invalid character 

DE= pointer to start of FCB 

A = invalid character 

General: 

AF and BC are altered. 

Example: 

See Sample Program C, lines 53-65. 
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3ET SVC Number 3 

Get One Byte From Device or File 

Gets a byte from a logical device or a file. The DCB TYPE byte (DCB + 0, Bit 0) 
must permit a GET operation for this call to be successful. 

Entry Conditions: 

A =3(X'03") 

DE = pointer to DCB or FCB 

Exit Conditions: 

Success, Z flag set. 

A = character read from the device or file 
Failure, NZ flag set. Test register A: 

If A = 0, no character was available. 

If A 4= 0, A contains error number. 

Example: 

See the section "Device Driver and Filter Templates." 
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GTDCB SVC Number 82 

Get Device Control Block Address 

Finds the location of a Device Control Block (DCB). If DE = (no device name 
specified), HL returns the address of the first unused DCB found. 

Entry Conditions: 

A =82(X'52') 

DE = 2-character device name (E = first character, D = second character) 

Exit Conditions: 

Success, Z flag set. DCB was found. 

HL = pointer to start of DCB 
Failure, NZ flag set. No DCB was available. 

A = Error 8 (Device not available) 

HL is altered. 

General: 

AF is always altered by this SVC. 

Example: 

See the section "Device Driver and Filter Templates." 
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JT 8VC Nymber 81 

Code Table Address 

Gets the address of the Drive Code Table for the requested drive. 

Entry Conditions: 
A = 81 (X'5f) 
C= logical drive number (0-7) 

Exit Conditions: 
Success always. 

I Y = pointer to the DCT entry for the specified drive 
AF is always altered by this SVC. 

General: 

If the drive number is out of range, the IY pointer will be invalid. This call 
does not return Z/NZ to indicate if the drive number specified is valid 
(0-7) or enabled. 

Example: 

See the example for @DCSTAT in Sample Program D, lines 27-33. 
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GTMOD SVC Number 83 

Get Memory Module Address 

Locates a memory module, if the standard memory header is at the start of the 
module. The scanning starts with the system drivers in low memory, then 
moves to any high memory modules. If any routine is encountered that does not 
start with a proper header, scanning stops. 

Entry Conditions: 

A =83(X'53') 

DE = pointer to memory module name in upper case, terminated with any 
character in the range 00-31 

Exit Conditions: 

Success always. 

If the Z flag is set, the module was found. 

HL = pointer to first byte of memory header 
DE= pointer to first byte after module name 

If the NZ flag is set, the module was not found. 
HL is altered. 

General: 

AF is always altered by this SVC. 

Example: 

See Sample Program F, lines 144-154. 
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Fill fi^p 
MT S¥C Nyniber 52 

Hard Disk Format 

Passes a format drive command to a hard disk driver. If the hard disk controller 
accepts it as a valid command, then it formats the entire disk drive. If the hard 
disk controller does not accept it, then an error is returned. Radio Shack hard- 
ware does not currently support @HDFMT. 

Entry Conditions: 

A = 52(X'34') 

C= logical drive number (0-7) 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A = error number 
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@HEXDEC SVC Number 97 

Convert Binary to Decimal ASCII 

Converts a binary number in HL to decimal ASCII. 

Entry Conditions: 

A =97(X'61') 

HL = number to convert 

DE= pointer to 5-character buffer to hold converted number 

Exit Conditions: 

Success always. 

DE = pointer to end of buffer + 1 

AF, BC, and HL are altered by this SVC. 

Example: 

See Sample Program B, lines 73-76. 



271 



SVC Number §8 



lyte to Hex ASCII 



Converts a 1-byte number to hexadecimal ASCII. 

Entry Conditions: 
A =98(X'62') 
C = number to convert 
HL = pointer to a 2-character buffer to hold the converted number 

Exit Conditions: 
Success always. 

H L = pointer to the end of buffer + 1 
Only AF is altered by this SVC. 

Example: 

See Sample Program B, lines 236-246. 
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HEX16 SVC Number 99 



Convert 2 Bytes to Hex ASCII 



Converts a 2-byte number to hexadecimal ASCII. 

Entry Conditions: 

A =99(X'63') 

DE= number to convert 

HL= pointer to 4-character buffer to hold converted number 

Exit Conditions: 

Success always. 

HL = pointer to end of buffer + 1 
Only AF is altered by this SVC. 

Example: 

See Sample Program B, lines 248-258. 
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S ©r L©W$ 

Provides the means to read or alter the HIGH$ and LOW$ values. 

Note: HIGH$ must be greater than LOW$. LOW$ is reset to X'2FFF' by @EXIT 
©ABORT, and @CMNDI. 

Entry Conditions: 
A = 100(X'64') 
B selects HIGH$ or LOW$ 

If B = 0, SVC deals with HIGH$ 

If B 4= 0, SVC deals with LOW$ 
HL selects one of the following functions: 

If HL = 0, the current HIGH$ or LOW$ is returned 

If HL^0, then HIGH$ or LOW$ is set to the value in HL 

Exit Conditions: 

Success, Z flag set. 

HL = current HIGH$ or LOW$. If HL + on entry, then HIGH$ or LOW$ 
is now set to that value. 
Failure, NZ flag set. 
A = error number 

General: 

If bit of CFLAG$ is set (see ©FLAGS), then HIGH$ cannot be changed 
with this call. The call returns error 43, "SVC parameter error!' 

Example: 

See Sample Program F, lines 75-86. 
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@INIT SVC Number 58 

Open or Initialize File 

Opens a file. If the file is not found, this SVC creates it according to the file 
specification. 

Entry Conditions: 

A =58(X'3A') 

HL = pointer to 256-byte disk I/O buffer 

DE= pointer to FCB containing the file specification 

B = Logical Record Length to be used while file is open 

Exit Conditions: 

Success, Z flag set. File was opened or created. 

The CF flag is set if a new file was created. 
Failure, NZ flag set. 

A= error number 

General: 

Only AF is altered by this SVC. 

The file open bit is set in the directory if the access level is UPDATE or 
greater. 

Example: 

See Sample Program C, lines 260-272. 



275 



@IP 



SVC Number i 



Reboot the System 



Does a software reset. Floppy drive must contain a system disk. @IPL uses 
the standard boot sequence, the same as for a hard reset (pressing the reset 
button). Memory locations X'41 E5'-X'4225' and X'4300'-X'43FF are altered 
during the boot of the machine. 



Entry Conditions: 
A = 0(XW) 

General: 

This SVC does not return. 
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KBD SVC Number 8 



Scan Keyboard and Return 



Scans the keyboard and returns a character if a key is pressed. If no key is 
pressed, a zero value is returned. 

Entry Conditions: 

A = 8(X'08') 

Exit Conditions: 

Success, Z flag set. 

A = character pressed 
Failure, NZ set. 

If A = 0, no character was available. 

If A 4= 0, then A contains error number. 

Gsnsrsl* 

DE is altered by this SVC. 

Example: 

See Sample Program C, lines 198-200. 
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S¥C Number 1 



Dewice, Wait for Character 



Scans the *KI device and returns with a character. It does not return until a 
character is input to the device. 

Note: The system suspends execution of the program that issued the SVC until 
a character can be obtained. Background tasks will continue to run normally. 

Entry Conditions: 

a=i (X'or) 

Exit Conditions: 

Success, Z flag set. 

A = character entered 
Failure, NZ flag set. 
A = error number 

General: 

DE is altered by this SVC. 

Example: 

See Sample Program B, lines 202-203. 
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EY1N SVC Number 9 



Accept a Line of Input 



Accepts a line of input until terminated by either an (ENTER) or a (BREAK) . Entries 
are displayed on the screen, starting at the current cursor position. Backspace, 
tab, and line delete are supported. If JCL is active, the line is fetched from the 
active JCL file. 

Entry Conditions: 

A =9(XW) 

HL = pointer to user line buffer of length B+1 
B = maximum number of characters to input 
C =0 

Exit Conditions: 

Success, Z flag set. 

HL = pointer to start of buffer 

B = actual numb er of characters input 

CF is set if (break) terminated the input. 
Failure, NZ flag set. 

A = error number 

General: 

DE and C are altered by this SVC. 

Example: 

See Sample Program C, lines 39-47. 
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JSK SVC Number 32 



Remowe Currently Executing Task 



When called by an executing task driver, removes the task assignment from the 
task table and returns to the foreground application that was interrupted. 

Entry Conditions: 
A = 32(X'20') 

General: 

This SVC does not return. 

Example: 

See the example for @RMTSK in Sample Program F, lines 134-142. 
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LOAD SVC Number 76 



Load Program File 



Loads a program file. The file must be in load module format. 

Entry Conditions: 

A =76(X'4C) 

DE = pointer to FCB containing filespec of the file to load 

Exit Conditions: 

Success, Z flag set. 

HL = transfer address retrieved from file 
Failure, NZ flag set. 

A = error number 

Example: 

See Sample Program A, lines 50-56. 
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@L0C SVC Number 63 

Calculate Current Logical Record Number 

Returns the current logical record number. 

Entry Conditions: 
A =63(X'3F') 
DE = pointer to the file's FCB 

Exit Conditions: 

Success, Z flag set. 

BC = logical record number 
Failure, NZ flag set. 
A = error number 

General: 

AF is altered by this SVC. 

Example: 

See Sample Program C, lines 305-311. 
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LOF SVC Number 64 

Calculate the EOF Logical Record Number 

Returns the EOF (End of File) logical record number. 

Entry Conditions: 

A =64(X'40') 

DE = pointer to FCB for the file to check 

Exit Conditions: 

Success, Z flag set. 

BC = the EOF logical record number 
Failure, NZ flag set. 

A = error number 

General: 

Only AF is altered by this SVC. 

Example: 

See the example for @LOC in Sample Program C, lines 305-311. 
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lumber* 11 



Issues a log message to the Job Log. The message can be any character string 
terminating with a carriage return (XW). 

Entry Conditions: 
A =11 (X'OB') 
HL = pointer to first character in message line 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A= error number 

General: 

Only AF is altered by this SVC. 

Example: 

LD HL >TEXT SPoint at messafle to output 
LD A fiLOGER Sand output it to the Job 

iLoS 
RST 28H SCall the §LOGER SMC 

♦ ♦ ♦ 

TEXT: DEFM 'This is a message for the Job Losf' 

DEFB 0DH 5Messa3e must be terminated 
5 with an < ENTER >. 
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LQGQT SVC Number 12 

Display and Log Message 

Displays and logs a message. Performs the same function as @DSPLY fol- 
lowed by @LOGER. 

Entry Conditions: 

A =12(X'0C) 

HL = pointer to first character in message line 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A = error number 

General: 

Only AF is altered by this SVC. 

To avoid a looping condition that could result from the display device gen- 
erating an error, no error checking should be done after returning from 
@LOGOT. 

Example: 

LD HLjTEXT iPoint at message to output 
LD A»@L0G0T 5 and output it to the Job 

5 Lost AND the display 
RST 28H iCall the 0LOGOT BMC 

♦ i ♦ 

TEXT: DEFM 'This message will be displayed both in' 
DEFM 'the Job Lotf and on the display.' 
DEFB 0DH iMust terminate text with an 
!< ENTER >. 
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S¥C Number 13 



Sends a message line to any device or file. 

Entry Conditions: 
A =13(X'0D') 

DE= pointer to DCB or FCB of device or file to receive output 
HL = pointer to message line terminated with X'0D' or X'03' 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A= error number 

General: 

Only AF is altered by this SVC. 

Example: 

5 Point at message to output 
5Point at the device control 
IblocK for our device 
Sand write this text to it 
SCall the iMSG SMC 



LD 


*HL»TEXT 


LD 


DE »DCBP 


LD 


A.0MSG 


RST 


28H 



TEXT: DEFM 'D555-555<L0GIN USER>' SText to write to 

! t h i s device, In this case* 
lit is a dialing modem. 
DEFB 03H STerminate the message 



286 



@MUL8 SVC Number 90 

8-Bit Multiplication 

Performs an 8-bit by 8-bit unsigned integer multiplication. The resultant product 
must fit into an 8-bit field. 

Entry Conditions: 

A = 90(X'5A') 
C= multiplicand 
E = multiplier 

Exit Conditions: 
Success always. 
A= product 
DE is altered by this SVC. 

Example: 

See Sample Program B, lines 150-153. 
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@ 



IL16 SVC Number 91 



16-Bit by 8-Bit multiplication 



Performs an unsigned integer multiplication of a 16-bit multiplicand by an 8-bit 
multiplier. The resultant product is stored in a 3-byte register field. 

Entry Conditions: 
A =91 (X'5B*) 
HL = multiplicand 
C = multiplier 

Exit Conditions: 
Success always. 

HL = two high -order bytes of product 
A = low-order byte of product 
DE is altered by this SVC. 

Example: 

See Sample Program B, lines 183-187. 
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OPEN SVC Number 59 



Open Existing File or Device 

Opens an existing file or device. 



Entry Conditions: 

A =59(X'3B') 

HL = pointer to 256-byte disk I/O buffer 

DE= pointer to FCB or DCB containing filespec or devspec 

B = logical record length for open file 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A= error number 

General: 

AF is altered by this SVC. 

The file open bit is set in the directory if the access level is UPDATE or 
greater. 

Example: 

See Sample Program C, lines 134-150. 
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>p&m 



ir@@ Parameter String 



Parses an optional parameter string. Its primary function is to parse command 
parameters contained in a command line starting with a parenthesis. The 
acceptable parameter format is: 

PARM = X'nnnn'.... hexadecimal entry 

PARM = nnnnn ....decimal entry 

PARM = "string" ...alphanumeric entry 

PARM = flag ....ON, OFF, Y, N, YES, or NO 

Note: Entering a parameter with no equal sign or value is the same as 
using PARM = ON. Entering PARM= with no value is the same as 
using PARM = OFF 

Entry Conditions: 
A =17(X'1f) 

DE= pointer to beginning of your parameter table 
HL= pointer to command line to parse (the parameter string is enclosed 
within parentheses) 

Exit Conditions: 
Success always. 

If Z is set, either valid parameters or no parameters were found. 
If NZ is set, a bad parameter was found. 

General: 

NZ is not returned if parameter types other than those specified are 
entered. The application must check the validity of the response byte. 

The valid parameters are contained in a user table which must be in one of the 
following formats. (Parameter names must consist of alphanumeric charac- 
ters, the first of which is a letter.) 

For use with TRSDOS Version 6, use this format: 

The parameter table starts with a single byte X'80.' Each parameter is 
stored in a variable length field as described below. 

1) Type Byte (Type and length byte) 
Bit 7 — If set, accept numeric value 
Bit 6— If set, accept flag parameter 
Bit 5 — If set, accept "string" value 

Bit 4— If set, accept first character of name as abbreviation 
Bits 3-0— Length of parameter name 

2) Actual Parameter Name 

3) Response byte (Type and length found) 
Bit 7 — Numeric value found 

Bit 6 — Flag parameter found 

Bit 5— String parameter found 

Bits 4-0— Length of parameter entered. If length is and the 2-byte 
vector points to a quotation mark (X'22'), then the parameter 
was a null string. Otherwise, a length of indicates that the 
parameter was longer than 31 characters. 

4) 2-byte address vector to receive the parsed parameter values. 

The 2-byte memory area pointed to by the address field of your table 
receives the value of PARM if PARM is non-string. If a string is entered, the 
2-byte memory area receives the address of the first byte of "string." The 
entries ON, YES, and Y return a value of X'FFFF'; OFF, NO, and N return 
X'0000.' If a parameter name is specified on the command line and is fol- 
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lowed by an equal sign and no value, then X'0000' or NO is returned. If a 
parameter name is used on the command line without the equal sign, then 
a value of X'FFFF' or ON is assumed. For any allowed parameter that is 
completely omitted on the command line, the 2-byte area remains 
unchanged and the response byte is 0. 

The parameter table is terminated with a single byte X'00.' 
For compatibility with LDOS 5.1.3, use this format: 

A 6-character "word" left justified and padded with blanks followed by a 2- 
byte address to receive the parsed values. Repeat word and address for as 
many parameters as are necessary. You must place a byte of X'00' at the 
end of the table. 



Example: 



LD 


HL»COMAND 


LD 


DE»PARM 


LD 


A,§PARAM 


RST 


28H 


JR 


NZ »ERROR 


LD 


A,(RESP) 


AND 


040H 


JR 


Z »BAD 


LD 


A, (MAL) 


OR 


A 


JR 


Z»OFF 



JR 



ON 



COMAND: 


♦ i ♦ 

DEFS 


80 


5 


PARM: 


DEFB 


B0H 


i 
3 




DEFB 


40H+G 


5 

5 




DEFM 


'UPDATE' 


5 
5 


RESP: 


DEFB 





5 




DEFW 


MAL 


5 




DEFB 





5 


MAL: 


DEFS 


o 

£. 


5 
5 



SPoint at command buffer 

i Point at parameter list 

! P a r s e the items on the 

I command 1 ine 

iCall the BPARAM SMC 

5 An error occurred (not 

iinoluded here) 

i G e t response code 

iTest response f 1 a 3 s 

5User specified something 

5 like UPDATE=X'1234' or 

;UPDATE= "HELLO" 

5 Get 1st byte of UAL word 

!Test the value 

5UPDATE=0FF or UPDATE=NO was 

5 spec i f ied 

5UPDATE=0N or UPDATE=YES was 

jspecified 



Area where command is 

stored 

Table header code 

40 savs we want a flaS 

(YES/NO). 6 is 1 en 3th of 

the parameter name 

Parameter name 

Response area 

Vector to MAL 

End of Table code 

Area to receive a parameter 

v a 1 u e 
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SVC Number 16 



ipend Program Execution 



Suspends program execution for a specified period of time and goes into a 
"holding" state. I he delay is at least 14.3 microseconds per count. 

Entry Conditions: 

A =16(X'10') 
BC = delay count 

Exit Conditions: 

Success always. 

Example: 



LD 



LD 
RST 



BC3GA2H 



A»iPAUSE 
28H 



iklait for 

iseoands* 

513986 is 

5 m s e c s 

5 S u s p e n d execution 

iCall the OPAUSE SYC 



about 200 Willi. 
14.3 usees * 
approx. 200 
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PEOF SVC Number 65 



Position to End Of File 



Positions an open file to the End Record Number (ERN). An end-of-file- 
encountered error (X"IC) is returned if the operation is successful. Your pro- 
gram may ignore this error. 

Entry Conditions: 

A =65(X'4T) 

DE = pointer to FCB of the file to position 

Exit Conditions: 

NZ flag always set. 

If A = X'1 C then success. 
If A * X'1C; then failure. 
A= error number 

General: 

AF is always altered by this SVC. 

Example: 

See the example for @LOC in Sample Program C, lines 305-311. 
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Position File 



Positions a file to a logical record. This is useful for positioning to records of a 
random access file. 

When the @POSN routine is used, Bit 6 of FCB + 1 is automatically set. This 
ensures that the EOF (End Of File) is updated when the file is closed only if the 
NRN (Next Record Number) exceeds the current ERN (End Record Number). 

Note that @POSN must be used for each write, even if two records are side by 
side. 

Entry Conditions: 
A =66(X'42") 

DE = pointer to FCB for the file to position 
BC = the logical record number 

Exit Conditions: 

if Z flag is set or A = X'1 C or X'1 D,' then success. 

The file was positioned. 
Otherwise, failure. 
A = error number 

General: 

AF is always altered by this SVC. 

Example: 

See the example for @LOC in Sample Program C, lines 305-311. 
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IT SVC Number 14 



Prints Message Line 



Outputs a message line to the printer. The line must be terminated with either a 
carriage return (X'OD') or an ETX (X'03'). 

Entry Conditions: 
A = 14(X'0E) 
HL = pointer to message to be output 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A = error number 

General: 

AF and DE are altered by this SVC. 

Example: 

LD HLjTEXT !Text to be output to the 

iprinter 
LD A»@PRINT iklrite this message to the 

iprinter device 
RST 28H ICall the SPRINT SMC 

4 4 4 

TEXT: DEFB 0CH 5 Do a Top of Form 

DEFM 'Report continued PaSe ' 

DEFB 3 !Te muriate with a <ETX> or 
Jan < ENTER > 



295 



IT SVC Number 6 



lend Character to Printer 



Outputs a byte to the line printer. 

Entry Conditions: 
A = 6(X'06') 
C = character to print 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A = error number 

General: 

AF and DE are altered by this SVC. 

If the line printer is attached but becomes unavailable (out of paper, out of 
ribbon, turned off, off-line, buffer full, etc.), the printer driver waits approx- 
imately ten seconds. If the printer is still not ready, a "Device not avail- 
able" error is returned. 

Example: 

LD A>(PAGE) 5Get the pasfe number 

ADD A»'0' iMaKe it ASCII 

LD C»A 5 Put the ualue here 

LD A t@PRT IWrite this character to the 

Sprinter 

RST 28H 5 Call the @PRT SVC 

♦ » ♦ 

PAGE: DEFB 2 iStart with pa3e 2 
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PUT SVC Number 4 

Write One Byte to Device or File 

Outputs a byte to a logical device or file. The DCB TYPE byte (DCB + 0, Bit 1 ) 
must permit PUT operation. 

Entry Conditions: 

A =4(X'04') 

DE = pointer to DCB or FCB of the output device 

C = byte to output 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A = error number 

General: 

AF is always altered by this SVC. 

Example: 

See the section "Device Driver and Filter Templates." 
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SMiDI 



it Directory [Reeord @r Free Spaci 



Reads the directory information of visible files from a disk directory, or gets the 

amount of free space on a disk. 

Entry Conditions: 
A =35(X'23') 

HL= pointer to RAM buffer to receive information 
B = logical drive number (0-7) 
C selects one of the following functions: 

If C = 0, get directory records of all visible files. 

If C = 255, get free space information. 

If C = 1-254, get a single directory record (see below). 

Exit Conditions: 

Success, Z flag set 
Failure, NZ flag set. 
A = error number 

Each directory record requires 22 bytes of space in the buffer. If C = 0, one addi- 
tional byte is needed to mark the end of the buffer. 

For single directory records, the number in the C register should be one less 
than the desired directory record. For example, if C = 1, directory record 2 is 
fetched and put in the buffer. If a single record request is for an inactive record 
or an invisible file, the A register returns an error code 25 (File access denied). 

The directory information is placed in the buffer as follows: 

Byte Contents 

00-1 4 filename/ext:d (left justified, padded with spaces) 

1 5 protection level, to 6 

16 EOF offset byte 

1 7 logical record length, to 255 
18-19 ERNoffile 

20-21 file size in K (1024-byte blocks) 

22 LAST RECORD ONLY. Contains " + " to mark buffer end. 

If C = 255, HL should point to a 4-byte buffer. Upon return, the buffer contains: 

Bytes 00-01 Space in use in K, stored LSB, MSB 
Bytes 02-03 Space available in K, stored LSB, MSB 

Example: 

See the example for @DODIR in Sample Program E, lines 32-40. 
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DR SVC Number 48 



Read a Sector Header 



Reads the next ID header when supported by the controller driver. The floppy 
disk driver supplied treats this as a @RDSEC (SVC 49). 

Entry Conditions: 

A =48(X'30') 

HL = pointer to buffer to receive the data 

D = cylinder to read 

C = logical drive number 

E = sector to read 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A = error number 

Example: 

See the example for @RDSEC in Sample Program D, lines 63-66. 
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@ IRDBEC SVC Number 49 



Transfers a sector of data from the disk to your buffer. 

Entry Conditions: 
A =49(X'3f) 

HL = pointer to the buffer to receive the sector 
D = cylinder to read 
E = sector to read 
C = logical drive number (0-7) 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A= error number 

General: 

Only AF is altered by this SVC 

Example: 

See Sample Program D, lines 63-66. 
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RDSSC SVC Number 85 

Read System Sector 

Reads the specified system (directory) sector. If the cylinder number in register 
D is not the directory cylinder, the value in D is changed to reflect the real direc- 
tory cylinder and the sector is then read. 

Entry Conditions: 

A =85(X'55') 

HL = pointer to the buffer to receive the sector 

D = cylinder to read 

E = sector to read 

C = logical drive number (0-7) 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A = error number 

General: 

Only AF is altered by this SVC. 

Example: 

See Sample Program D, lines 78-92. 
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m 



W€ Wumb@r 51 



i Traci 



Reads an entire track when supported by the controller driver. The floppy disk 
driver supplied treats this as a @RDSEC (SVC 49) and does not do a track 
read. 

Entry Conditions: 
A =51 (X'33') 

HL = pointer to buffer to receive the sector 
D = track to read 
C = logical drive number 
E = sector to read 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A = error number 

General: 

AF is altered by the supplied floppy disk driver. 

Example: 

See the example for @RDSEC in Sample Program D, lines 63-66. 
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@READ SVC Number 67 



lead a Record 



Reads a logical record from a file. If the LRL defined at open time was 256 
(specified by 0), then the NRN sector is transferred to the buffer established at 
open time. For LRL between 1 and 255, the next logical record is placed into a 
user record buffer, UREC. The 3-byte NRN is updated after the read operation. 

Entry Conditions: 

A =67(X'43') 

DE= pointer to FCB for the file to read 

HL= pointer to user record buffer UREC (needed if LRL = 1-255; unused if 
LRL = 256) 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A = error number 

Example: 

See Sample Program C, lines 300-304. 
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SVG Number 57 



teraowe File or Bewiee 



Removes a file or device. 

If a file is to be removed, the File Control Block must be in an open condition. 
When this SVC is performed, the file's directory is updated and the space occu- 
pied by the file is deallocated. 

If a device was specified, the device is closed. To remove a device, use the 
REMOVE library command. 

Entry Conditions: 
A =57(X'39") 
DE = pointer to FCB or DCB to remove 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A= error number 

Example: 

See Sample Program C, lines 223-231. 
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SVC Number 56 



Rename File or Device 



Changes a file's filename and/or extension. 

Entry Conditions: 

A =56(X'38') 

DE= pointer to an FCB containing the file's current name 

This FCB must be in a closed state. 
HL = pointer to new filename string terminated with a X'0D' or X'Q3'. This 

filespec must be in upper case and must be a valid filespec. You can 

convert the filespec to upper case and check its validity by using the 

@FSPEC SVC before using @RENAM. 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A = error number 

General: 

After the call is completed, the FCB pointed to by DE is altered. 
Only AF is altered by this SVC. 

Example: 

L.D 



LD 



LD 



RST 



DEtFCB 



HL»NEW 



A»@RENAM 



!8H 



5 P o i n t at a 

5 c o n t a i n i n 9 

i filespec 

i P o i n t to the 

5 1 o use 

5 Ch arise the name 

if ile 

iCall the iRENAM 



closed FCB 
the old 



new filespec 



of the 



SVC 



FCB: DEFS 32 



NEN: DEFM 'NEWNAME/TXT ■ 
DEFB 0DH 



! A File Control Block used 

5 by the 0RENAM BMC. In 

5 this example* it is 

5 assumed that an SFSPEC 

iSMC has loaded a filespec 

5 into the FCB before the 

i@RENAM BUC is performed. 

i T h e new filespec for the 

if ile 

iTerminate the filespec 
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SVC Number 68 



lewind File to Beginning 



Rewinds a file to its beginning and resets the 3-byte NRN to 0. The next record 
to be read or written sequentially is the first record of the file. 

Entry Conditions: 
A =68(X'44") 
DE = pointer to FCB for the file to rewind 

Exit Conditions: 

Success, Z flag set. File positioned to record number 0. 
Failure, NZ flag set. 
A = error number 

General: 

AF is always altered by this SVC. 

Example: 

See the example for @LOC in Sample Program C, lines 305-311. 
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ITSK SVC Number 30 



temowe Interrupt Level Task 

Removes an interrupt level task from the Task Control Block table. 

Entry Conditions: 

A = 30(X'1E') 

C = task slot assignment to remove (0-1 1 ) 

Exit Conditions: 

Success always. 

HL and DE are altered by this SVC. 

Example: 

See Sample Program F, lines 134-142. 
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IK SVC Number 31 



Replace Task Vector 



Exits the task process executing and replaces the currently executing task's 
vector address in the Task Control Block table with the address following the 
SVC instruction. Return is made to the foreground application that was 
interrupted. 

Entry Conditions: 
A = 31 (X'1F) 

General: 

This SVC does not return. 

Example: 

LD AjRPTSK 5 Re place this task with the 
5one located at the 
ifollowina address: 
RST 28H iCall the BRPTSK SVC 

NEWADDs DEFW iAddress of the new task is 

iloaded here, This word 
!must be immediately after 
ithe 0RPTSK SMC, The label 
iNENADD is present only to 
Sallow the address to be 
5 s t o r e d , 
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D SVC Number 69 



Reread Sector 



Forces a reread of the current sector to occur before the next I/O request is per- 
formed. Its most probable use is in applications that reuse the disk I/O buffer for 
multiple files, to make sure that the buffer contains the proper file sector. This 
routine is valid only for byte I/O or blocked files. Do not use it when positioned 
at the start of a file. 

Entry Conditions: 

A =69(X'45') 

DE = pointer to FCB for the file to reread 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A = error number 

General: 

AF is always altered by this SVC. 

Example: 

LD DE»FCB iPoint to. File Control Block 
5 o f the file that requires 
ithe re-read 

LD A»§RREAD 5Before next I/0> reload 
ithe current sector into 
ithe system buffer for 
j this file 

RST 28H iCall the iRREAD BMC 
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iLCT SVC Number 47 



Test for Driwe Busy 



Performs a test of the last selected drive to see if it is in a busy state. If busy, it 
is re-selected until it is no longer busy. 

Entry Conditions: 
A = 47(X'2F') 
C= logical drive number (0-7) 

Exit Conditions: 

Success always. 

Only AF is altered by this SVC. 

Example: 

LD C>1 iTest Drive 1 to see if it 

5is bus y 
LD A»@RSLCT 5 If it is. continue 

5selectin«f it 
RST 28H iCall the ORSLCT SMC 
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RSTOR SVC Number 44 



Issue FDC RESTORE Command 



Issues a disk controller RESTORE command. 

Entry Conditions: 

A = 44(X'2C) 

C= logical drive number (0-7) 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A= error number 

Example: 

See the example for @CKDRV in Sample Program D, lines 38-39. 



311 



Loads and executes a program file. If an error occurs during the load, the sys- 
tem prints the appropriate message and returns. 

Entry Conditions: 
A =77(X'4D') 

DE = pointer to FCB containing the filespec of the file to RUN 
Note: The FCB must be located where the program being loaded will not 
overwrite it. 

Exit Conditions: 

Success, the new program is loaded and executed. 

Failure, the error is displayed and return is made to your program. 

HL = return code (See the section "Converting to TRSDOS Version 6" 
for information on return codes.) 

General: 

HL is returned unchanged if no error occurred and can be used as a 
pointer to a command line. 

Example: 

See Sample Program A, lines 62-74. 
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IT SVC Number 70 



Rewrite Sector 



Rewrites the current sector, following a write operation. The @WRITE function 
advances the NRN after the sector is written. @RWRIT decrements the NRN 
and writes the disk buffer again. Do not use @RWRIT when positioned to the 
start of a file. 

Entry Conditions: 

A =70(X'46') 

DE = pointer to FCB for the file to rewrite 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A = error number 

Example: 

LD DEtFCB iPoint to the File Control 

i B 1 o c K 
LD A>@RWRIT iPerform a re -write of the 

icurrent sector 
RST 28H 5 Call the 0RWRIT SMC 
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SVC Number 48 



linder 



Seeks a specified cylinder and sector. @SEEK does not return an error if you 
specified a non-existent drive or an invalid cylinder. @SEEK performs no action 
if the specified drive is a hard disk. 

Note: Seek of a sector is not supported by TRS-80 hardware. An implied seek 
is included in sector reads and writes. 

Entry Conditions: 
A = 46(X'2E') 
C= logical drive number 
D=cylindertoseek 
E = sector to seek 

Exit Conditions: 
Success always. 
Only AF is altered by this SVC. 
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SVC Number 71 



ieek Cylinder and Sector 



Seeks the cylinder and sector corresponding to the next record of the specified 
file. (This is done by examining the NRN field of the FCB.) No error is returned 
on physical seek errors. 

Entry Conditions: 

A =71 (X'47') 

DE = pointer to the file's FCB 

Exit Conditions: 

Success always. 

Example: 

LD DE>FCB SPoint to the File Control 

5 B 1 o c K 
LD A»iSEEKSC 5Cause the next sector to be 

SSEEKed before it is 

5 a c t u a 1 1 v n e e d e d 
RST 28H 5Call the iSEEKSC SMC 
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Causes a skip past the next logical record. Only the record number contained 
in the FCB is changed; no physical I/O takes place. 

Entry Conditions: 
A =72(X'48") 
DE = pointer to FCB for the file to skip 

Exit Conditions: 

If the Z flag is set or if A = X'1 C or X'1 D,' then the operation was successful. 
Otherwise, A = error number. If A = X'1C is returned, the file pointer is 
positioned at the end of the file. Any Appending operations would be 
performed here. If A = X'1 D' is returned, the file pointer is positioned 
beyond the end of the file. 

General: 

AF is altered by this SVC. 

BC contains the current record number. This is the same value as that 
returned by the @LOC SVC. 

Example: 

See the example for @LOC in Sample Program C, lines 305-311. 



316 



SLCT SVC Number 41 



Select a New Driwe 



Selects a drive. The time delay specified in your configuration (SYSTEM 
(DELAY = Y/N)) is made if the drive selection requires it. 

Entry Conditions: 

A = 41 (X'29') 

C= logical drive number (0-7) 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A = error number 

General: 

Only AF is altered by this SVC. 
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id Generation 



Generates sound using specified tone and duration codes. Interrupts are dis- 
abled during execution. 

Entry Conditions: 

A = 104(X'68') 

B = function code 

bits 0-2: tone selection (0-7 with = highest and 7 = lowest) 
bits 3-7: tone duration (0-31 with = shortest and 31 = longest) 

Exit Conditions: 
Success always. 

Only AF is altered by this SVC. 

Example: 

See Sample Program B, lines 43-45. 
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SVC Number 45 



Issue FDC STEP IN Command 



Issues a disk controller STEP IN command. This moves the drive head to the 
next higher-numbered cylinder. @STEPI is intended for sequential read/write 
operations, such as disk formatting. 

Entry Conditions: 

A = 45(X'2D') 

C= logical drive number 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A = error number 

General: 

Only AF is altered by this SVC. 
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Timi 



Gets the system time in display format (HH:MM:SS). 

Entry Conditions: 
A =19(X'13') 
HL= pointer to buffer to receive the time string 

Exit Conditions: 
Success always. 

HL = pointer to the end of buffer + 1 

DE= pointer to start of TIMES storage area in TRSDOS 

AF and BC are altered by this SVC. 

Example: 

See the example for @DATE in Sample Program F, lines 252-253. 
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L SVC Number 15 



Video Functions 



Performs various functions related to the video display. The B register is used 
to pass the function number. 

Entry Conditions: 

A=15(X'0F) 

B selects one of the following functions: 

If B = 1, return the character at the screen position specified by HL. 
H = row on the screen (0-23), where is the top row 
L = column on the screen (0-79), where is the leftmost column 

If B = 2, display the specified character at the position specified by 
HL. 
C = character to be displayed 
H = row on the screen (0-23), where is the top row 
L = column on the screen (0-79), where is the leftmost column 

If B = 3, move the cursor to the position specified by HL. This is done 
even if the cursor is not currently displayed. 
H = row on the screen (0-23), where is the top row 
L = column on the screen (0-79), where is the leftmost column 

If B = 4, return the current position of the cursor. 

If B = 5, move a 2048-byte (2K) block of data to video memory. Only 
1920 bytes of this are displayed, but a 2K area should be main- 
tained if you plan to read information back from the video using 
the same area of memory. 
HL = pointer to 2K area to he moved to video memory 
HL must be in the range X'23FF < HL < X'EC01.' 

If B = 6, move a 2048-byte (2K) block of data from video memory to 
a buffer you supply. The first 1920 bytes contain the data that 
is on the screen in 80x24 display mode. The remaining bytes 
are the remainder of the video RAM area. 

If B = 7, scroll protect the specified number of lines from the top of the 
screen. 
C = number of lines to scroll protect (0-7). Once set, scroll protect 
can be removed only by executing @VDCTL with B = 7 and 
C = 0, or by resetting the system. Clearing the screen with 
(SHIFTXCLEAR) erases the data in the scroll protect area, but the 
scroll protect still exists. 

If B = 8, change cursor character to specified character. If the cursor 
is currently not displayed, the character is accepted anyway 
and is used as the cursor character when it is turned back on. 
C = character to use as the cursor character 

Exit Conditions: 

If B = 1: 

Success, Z flag set. 

A = character found at the location specified by HL 

DE is altered. 
Failure, NZ flag set. 

A = error number 

If B = 2: 

Success, Z flag set. 

DE is altered. 
Failure, NZ flag set. 

A = error number 
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If B = 3: 

Success, Z flag set. 

DE and HL are altered. 
Failure, NZ flag set. 

A = error number 

If B = 4: 

Success always. 

\-\L = row and column position of the cursor. H = row on the 
screen (0-23), where is the top row; L = column on the 
screen (0-79), where is the leftmost column. 

If B = 5: 

Success always. 

HL = pointer to the last byte moved to the video + 1 
BC and DE are altered. 

If B = 6: 

Success always. 

BC, DE, and HL are altered. 

If B = 7: 

Success always. 

BC and DE are altered. 

If B = 8: 

Success always. 

A = previous cursor character 
DE is altered. 

General: 

Functions 5, 6, and 7 do not do range checking on the entry parameters. 
If HL is not in the valid range in functions 5 and 6, the results may be 

unpredictable. 
Only function 3 (B = 3) moves the cursor. 
If C is greater than 7 in function 7, it is treated as modulo 8. 
AF and B are altered by this SVC. 

Example: 

See Sample Program F, lines 304-327. 
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VER 



SVC Number 73 



Write and Verify a Record 



Performs a @WRITE operation followed by a test read of the sector (if the write 
required physical I/O) to verify that it is readable. 

If the logical record length is less than 256, then the logical record in the user 
buffer UREC is transferred to the file. If the LRL is equal to 256, a full sector 
write is made using the disk I/O buffer identified at file open time. 

Entry Conditions: 

A =73(X'49') 

DE = pointer to FCB for the file to verify 

Exit Conditions: 

Success, Z flag set. 

HL = pointer to user buffer containing the logical record 
Failure, NZ flag set. 

A = error number 

General: 

Only AF is altered by this SVC. 

Example: 

See Sample Program C, lines 338-346. 
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Verifies a sector without transferring any data from disk. 

Entry Conditions: 
A = 50(X'32") 
D = cylinder to verify 
E = sector to verify 
C = logical drive number (0-7) 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set 
A = error number 

General: 

AF is always altered by this SVC. 

If the sector is a system sector, the sector is readable if an error 6 is 
returned; any other error number signifies an error has occurred. 

Example: 

See the example for @WRSEC in Sample Program D, lines 68-76. 
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SVC Number 74 



Write End Of File 



Forces the system to update the directory entry with the current end-of-file 
information. 

Entry Conditions: 

A =74(X'4A') 

DE = pointer to the FCB for the file to WEOF 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A = error number 

General: 

AF is always altered by this SVC. 

Example: 

LD DE>FCB ! Point at the File Control 

; b i o c k 

LD A*@WEOF SForce the directory entry 
5 1 o be updated n o w t 
! i n s t e a d of when the file 
iis closed 

RST 2BH JCall the @WE0F SMC 
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HERE SVC Number 7 



Locate Origin of SVC 



Used to resolve the relocation address of the calling routine. 

Entry Conditions: 

A = 7(X'07') 

Exit Conditions: 

Success always. 

HL = pointer to address following RST 28H instruction 
AF is always altered by this SVC. 

Example: 

See Sample Program F, lines 36-60. 
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©WRITE SVC Number 75 



Write a Record 



Causes a write to the next record identified in the File Control Block. 

If the logical record length is less than 256, then the logical record in the user 
buffer UREC is transferred to the file. If the LRL is equal to 256, a full sector 
write is made using the disk I/O buffer identified at file open time. 

Entry Conditions: 

A =75(X'4B") 

HL = pointer to user record buffer UREC (unused if LRL = 256) 

DE= pointer to FCB for the file to write 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A= error number 

General: 

AF is always altered by this SVC. 

Example: 

See the example for @VER in Sample Program C, lines 338-346. 
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SVC Number 58 



Writes a sector to the disk. 

Entry Conditions: 
A =53(X'35') 

HL = pointer to the buffer containing the sector of data 
D = cylinder to write 
E = sector to write 
C = logical drive number (0-7) 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A = error number 

General: 

Only AF is altered by this SVC. 

Example: 

See Sample Program D, lines 68-76. 
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WRSSC SVC Number 54 

Write a System Sector 

Writes a system sector (used in directory cylinder). 

Entry Conditions: 

A =54(X'36') 

HL = pointer to the buffer containing the sector of data 

D = cylinder to write 

E = sector to write 

C = logical drive number 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A = error number 

General: 

Only AF is altered by this SVC. 

Example: 

See Sample Program D, lines 94-104. 
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SVC Number 55 



Writes an entire track of properly formatted data. The data format must conform 
to that described in the disk controller's reference manual. @WRTRK must 
always be preceded by @SLCT. 

Entry Conditions: 
A =55(X'37") 
HL = pointer to format data 
D = track to write 
C = logical drive number (0-7) 

Exit Conditions: 

Success, Z flag set. 
Failure, NZ flag set. 
A = error number 

General: 

Only AF is altered by this SVC. 



330 



encai li 



Following is a numerical list of the SVCs: 
Dec Hex Label 






00 


©IPL 


1 


01 


@KEY 


2 


02 


@DSP 


3 


03 


@GET 


4 


04 


@PUT 


5 


05 


@CTL 


6 


06 


@PRT 


7 


07 


©WHERE 


8 


08 


@KBD 


9 


09 


@KEYIN 


10 


0A 


@DSPLY 


11 


0B 


@LOGER 


12 


0C 


@LOGOT 


13 


0D 


@MSG 


14 


0E 


@PRINT 


15 


0F 


@VDCTL 


16 


10 


©PAUSE 


17 


11 


©PARAM 


18 


12 


©DATE 


19 


13 


©TIME 


20 


14 


©CHNIO 


21 


15 


©ABORT 


22 


16 


©EXIT 


23 






24 


18 


©CMNDI 


25 


19 


©CMNDR 


26 


1A 


©ERROR 


27 


1B 


©DEBUG 


28 


1C 


©CKTSK 


29 


1D 


©ADTSK 


30 


1E 


©RMTSK 


31 


1F 


©RPTSK 


32 


20 


©KLTSK 


33 


21 


©CKDRV 


34 


22 


©DODIR 


35 


23 


©RAMDIR 


36-39 






40 


28 


©DCSTAT 


41 


29 


©SLCT 


42 


2A 


©DCINIT 


43 


2B 


©DCRES 


44 


2C 


©RSTOR 


45 


2D 


©STEPI 



Function 

Reboot the system 
Scan *KI device, wait for character 
Display character at cursor, advance 
cursor 

Get one byte from a logical device 
Write one byte to a logical device 
Make a control request to a logical 
device 

Send character to the line printer 
Locate origin of CALL 
Scan keyboard and return 
Accept a line of input 
Display a message line 
Issue a log message 
Display and log a message 
Message line handler 
Print a message line 
Position/locate cursor, get/put char- 
acter at cursor 
Suspend program execution 
Parse an optional parameter string 
Get system date in the format MM/ 
DD/YY 

Get system time in the format 
HH:MM:SS 

Pass control to the next module in a 
device chain 

Load HL with X'FFFF' error and goto 
©EXIT 

Exit program and return to TRSDOS 
Reserved for future use 
Entry to command interpreter with 
return to the system 
Entry to command interpreter with 
return to the user 
Entry to post an error message 
Enter DEBUG 
Check if task slot in use 
Add an interrupt level task 
Remove an interrupt level task 
Replace the currently executing task 
vector 

Remove the currently executing task 
Check for drive availability 
Do a directory display/buffer 
Get directory record(s) or free space 
into RAM 

Reserved for future use 
Test if drive is assigned in DCT 
Select a new drive 
Initialize the FDC 
Reset the FDC 

Issue FDC RESTORE command 
Issue FDC STEP IN command 
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Dec 



Hex 



Label 



Function 



46 


2E 


©SEEK 


47 


2F 


@RSLCT 


48 


30 


@RDHDR 


49 


31 


@RDSEC 


50 


32 


@VRSEC 


51 


33 


@RDTRK 


52 


34 


©HDFMT 


53 


35 


@WRSEC 


54 


36 


@WRSSC 


55 


37 


@WRTRK 


56 


38 


@RENAM 


57 


39 


©REMOV 


58 


3A 


@INIT 


59 


3B 


©OPEN 


60 


3C 


©CLOSE 


61 


3D 


©BKSP 


62 


3E 


©CKEOF 


63 


3F 


@LOC 


64 


40 


©LOF 


65 


41 


©PEOF 


66 


42 


©POSN 


67 


43 


©READ 


68 


44 


@REW 


69 


45 


©RREAD 


70 


46 


©RWRIT 


71 


47 


©SEEKSC 


72 


48 


©SKIP 


73 


49 


©VER 


74 


4A 


©WEOF 


75 


4B 


©WRITE 


76 


4C 


©LOAD 


77 


4D 


©RUN 


78 


4E 


©FSPEC 


79 


4F 


©FEXT 


80 


50 


©FNAME 


81 


51 


©GTDCT 


82 


52 


©GTDCB 


83 


53 


©GTMOD 


84 






85 


55 


©RDSSC 


86 






87 


57 


©DIRRD 


88 


58 


©DIRWR 


89 






90 


5A 


©MUL8 


91 


5B 


©MUL16 


92 






93 


5D 


©DIV8 


94 


5E 


©DIV16 


95 






96 


60 


©DECHEX 


97 


61 


©HEXDEC 



Seek a cylinder 

Test if requested drive is busy 

Read a sector header 

Read a sector 

Verify a sector 

Read a track 

Hard disk format 

Write a sector 

Write a system sector 

Write a track 

Rename a file 

Remove a file or device 

Open or initialize a file or device 

Open an existing file or device 

Close a file or device 

Backspace one logical record 

Check for end of file 

Calculate the current logical record 

number 

Calculate the EOF logical record 

number 

Position to the end of file 

Position a file to a logical record 

Read a record from a file 

Rewind a file to its beginning 

Reread the current sector 

Rewrite the current sector 

Seek a specified cylinder and sector 

Skip the next record 

Write a record to a file and verify 

Write end of file 

Write a record to a file 

Load a program file 

Load and execute a program file 

Fetch a file or device specification 

Set up a default file extension 

Fetch filename/extension from 

directory 

Get Drive Code Table address 

Find specified or first free DCB 

Find specified memory module 

address 

Reserved for future use 

Read a system sector 

Reserved for future use 

Read directory record 

Write directory record 

Reserved for future use 

Multiply 8-bit unsigned integers 

Multiply 16-bit by 8-bit unsigned 

integers 

Reserved for future use 

Divide 8-bit unsigned integers 

Divide 16-bit by 8-bit unsigned 

integers 

Reserved for future use 

Convert decimal ASCII to 16-bit 

binary value 

Convert a number in HL to decimal 

ASCII 



332 



Dec 



Hex 



Label 



Function 



98 
99 

100 


62 
63 
64 


@HEX8 

©HEX16 

@HIGH$ 


101 
102 


65 
66 


©FLAGS 
©BANK 


103 

104 

105-127 


67 
68 


©BREAK 
©SOUND 



Convert a 1-byte number to hex ASCII 
Convert a 2-byte number to hex ASCII 
Obtain or set the highest and lowest 
unused RAM addresses 
Point IY to the system flag table 
Check, set, or reset a 32K bank of 
memory 

Set user or system break vector 
Generate sound (tone and duration) 
Reserved for future use. 
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Alphabetical List ©f SVi 



Following is an alphabetical list of the SVC labels and numbers: 

Label Dec Hex 

©ABORT 21 15 

@ADTSK 29 1 D 

@BANK 102 66 

@BKSP 61 3D 

@BREAK 103 67 

©CHNIO 20 14 

@CKDRV 33 21 

@CKEOF 62 3E 

@CKTSK 28 1C 

©CLOSE 60 3C 

@CMNDI 24 18 

@CMNDR 25 19 

@CTL 5 5 

@DATE 18 12 

@DCINIT 42 2A 

@DCRES 43 2B 

@DCSTAT 40 28 

©DEBUG 27 1B 

@DECHEX 96 60 

@DIRRD 87 57 

@DIRWR 88 58 

@DIV8 93 5D 

@DIV16 94 5E 

@DODIR 34 22 

@DSP 2 2 

@DSPLY 10 0A 

©ERROR 26 1A 

©EXIT 22 16 

@FEXT 79 4F 

©FLAGS 101 65 

©FNAME 80 50 

©FSPEC 78 4E 

©GET 3 3 

©GTDCB 82 52 

©GTDCT 81 51 

©GTMOD 83 53 

©HDFMT 52 34 

©HEXDEC 97 61 

©HEX8 98 62 

©HEX16 99 63 

@HIGH$ 100 64 

©INIT 58 3A 

©IPL 

©KBD 8 8 

©KEY 1 1 

©KEYIN 9 9 

©KLTSK 32 20 

©LOAD 76 4C 

©LOC 63 3F 

©LOF 64 40 

©LOGER 1 1 0B 

©LOGOT 12 0C 

©MSG 13 0D 
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Label Dec Hex 

@MUL8 90 5A 

@MUL16 91 5B 

©OPEN 59 3B 

@PARAM 17 11 

©PAUSE 16 10 

@PEOF 65 41 

@POSN 66 42 

©PRINT 14 0E 

©PRT 6 6 

©PUT 4 4 

©RAMDIR 35 23 

©RDHDR 48 30 

©RDSEC 49 31 

©RDSSC 85 55 

©RDTRK 51 33 

©READ 67 43 

©REMOV 57 39 

©RENAM 56 38 

©REW 68 44 

©RMTSK 30 1E 

©RPTSK 31 1 F 

©RREAD 69 45 

©RSLCT 47 2F 

©RSTOR 44 2C 

©RUN 77 4D 

©RWRIT 70 46 

©SEEK 46 2E 

©SEEKSC 71 47 

©SKIP 72 48 

©SLCT 41 29 

©SOUND 104 68 

©STEPI 45 2D 

©TIME 19 13 

©VDCTL 15 0F 

©VER 73 49 

©VRSEC 50 32 

©WEOF 74 4A 

©WHERE 7 7 

©WRITE 75 4B 

©WRSEC 53 35 

©WRSSC 54 36 

©WRTRK 55 37 
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The following sample programs use many of 
the supervisor calls described in this man- 
ual. These programs are not meant to be 
examples of the most efficient programming, 
but are designed to illustrate as many super- 
visor calls as possible. 
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Sample Program A 



Ln # 

00001 
00002 
00003 
00004 
00005 
00001 



59 
00010 
00011 
00012 
00013 
00014 
00015 
00016 
00017 
00018 
00019 
00020 
00021 
00022 
00023 
00024 
00025 
00026 
00027 
00028 

0002 9 
00030 
00031 
00032 
00033 
00034 
00035 
00036 
00037 
00038 

0003 9 
00040 
00041 
00042 
00043 
00044 
00045 
00046 
00047 
00048 
00049 
00050 
00051 
00052 
0005 3 
0005 4 
00055 
0005 6 
00057 
0005 8 

0005 9 
00060 
00061 
00062 
00063 

0006 4 
00065 
0006 6 
00067 



Source Line 

This program asks the user whether to run a program 
or debug it and executes the SVCs required to perform 
the chosen action. 

PSECT 5000H ;The program begins at x'5000' 

Define the equates for the SVCs that will be used. 



©DEBUG: 
@DSPLY: 
@FSPEC: 

©KEY: 
@LOAD : 
@RUN: 

MESS1: 



PROGRM: 



FCBl: 



START : 



RUNIT: 



EQU 
EQU 
EQU 

EQU 
EQU 
EQU 

DEFM 
DEFB 
DEFM 
DEFB 

DEFM 
DEFB 



27 
10 
78 

1 

76 

77 



; Enter the debugger (DEBUG) 

;Display a message 

;Verify a filespec or devspec and 

;load it into a File Control Block 

;Get a character from the keyboard 

;Load a program into memory 

; Execute a program 



'Do you wish to RUN this Program or DEBUG it ?' 

0AH ;This moves the cursor to the next line 

'Press <ENTER> to RUN or <BREAK> to DEBUG' 

0DH ;Terminate the message string 

'DIREX/CMD' ; Sample program to debug or execute 
0DH ;Terminate the filespec 



DEFS 32 ;File Control Block for the program 

Get the File Control Block for the program 'DIREX/CMD' . 

;Point at the filespec we want to 
; execute or load into memory 
;Point at the File Control Block 
;Perform a validity check on the filespec 
;and copy the filespec into the FCB. 
;Call the ©FSPEC svc 

; Point at our prompting message 
;and print it on the display 
;Call the ©DSPLY svc 

;Get the reply from the keyboard 
;Call the @KEY svc 

;Was the character an <ENTER>? 

;If Z was set, then run the program 

If it wasn't an <ENTER>, then we assume it was a <BREAK> and 
load the program and enter the debugger. 



LD 


HL, PROGRM 


LD 


DE,FCB1 


LD 


A, ©FSPEC 


RST 


28H 


LD 


HL,MESS1 


LD 


A, ©DSPLY 


RST 


28H 


LD 


A, ©KEY 


RST 


28H 


CP 


0DH 


JR 


Z, RUNIT 



LD DE,FCB1 
LD A, © LOAD 
RST 28H 



;Point at the File Control Block 

;and have this program loaded into memory 

;Call the ©LOAD svc 



Note that this program must not be overwritten by the program 
we are loading. In this example, it is known that the program 
we are loading starts at x'3000' and ends below x'5000'. 



LD 
RST 



A,@DEBUG 
28H 



Execute the program 



LD 
LD 

RST 



DE,FCB1 
A, ©RUN 

28H 



;Now invoke the system debugger, DEBUG 

;Call the ©DEBUG svc 

;Note that ©DEBUG does not return 



Point at the File Control Block 

Tell TRSDOS to load and execute the 

program 

Call the @RUN svc 
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Sample Program A, continued 

^Jf°,i ;Note that @RUN returns only if it can't 

000 69 ;find the program 

00070 y 

00071 ; Note that the program that is loaded by the §RUN svc must not 

00072 : overwrite the Pile Control Block in this program. In this case, 

00073 ; it is known that the program we are executing starts at x'3000' 

00074 ; and ends below the starting point of this program, x'5000'. 
00075 

00076 END START 



338 



Sample Program B 



00001 
00002 
00003 
00004 
00005 
00006 
00001 



00010 
00011 
00012 
00013 
00014 
00015 
00016 
00017 
00018 
00019 
00020 
00021 
00022 
0002 3 
0002 4 
00025 
00026 
00027 
00028 

0002 9 
00030 
00031 
00032 
00033 
00034 
00035 
00036 
00037 

0003 8 

0003 9 
00040 
00041 
00042 
00043 

0004 4 
00045 
00046 
00047 
00048 

0004 9 
00050 
00051 

0005 2 
0005 3 
0005 4 
00055 
0005 6 
00057 
0005 8 

0005 9 
00060 
00061 
00062 

0006 3 
0006 4 
00065 
00066 
0006 7 
00068 



;This program accepts numbers from the keyboard 
;and uses them to demonstrate the 
;arithmetic and numeric conversion SVCs . 

;It also uses the sound function to produce a tone at the 
;beginning of the program. 

PSECT 3000H 

; These are the SVCs used in this program. 



@DECHEX:EQU 

§DIV8: EQU 

@DIV16: EQU 

@DSP: EQU 

@DSPLY: EQU 

@EXIT: EQU 
@HEX8: 
@HEX16: 
@HEXDEC:EQU 

@KEY: EQU 

@KEYIN: EQU 

@MUL8 : EQU 

@MUL16: EQU 

@SOUND: EQU 



EQU 
EQU 



96 
93 

94 

2 

10 

22 

98 

99 

97 

1 

9 

90 

91 

104 



;Convert decimal ASCII to binary 

;Perform 8-bit division 

;Perform 16-bit division 

;Display a character 

;Display a message 

;Return to TRSDOS Ready or the caller 

;Convert an 8-bit value to hex ASCII 

;Convert a 16-bit value to hex ASCII 

;Convert a binary value to Decimal ASCII 

;Read a character from *KI 

; Accept an input line from *KI 

;Perform 8-bit multiplication 

rPerform 16-bit multiplication 

;Produce a tone 



Other equates . 



NUM5 
NUM4 
NUM3 
NUM2 
NUMl 
BRK: 
CCC: 



EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 



5 

4 

3 

2 

1 

80H 

0DH 



;Character code for <BREAK> key 
;Next line position 



; Perform a subroutine 2 times to display prompting messages, key in 
;and display divisor and dividend, convert those numbers to 
;binary for the divide, and position the cursor. 



START : LD 
LD 
RST 
CALL 
LD 
LD 
LD 

CALL 
LD 
LD 

CALL 
CALL 
LD 
LD 



B,5AH 

A, @ SOUND 

28H 

KEYIN 

A,C 

(DIVDl) ,A 

HL,MESS9 

DSPLAY 

A, (DIVDl) 

C,A 

HEX8 

KEYIN 

A,C 

(DIVRl) ,A 



;Make the longest, highest tone 
;Make the noise 

;Perform keyin subroutine for dividend 

; Store the dividend in memory 

;Address of hex message 

;Display hex message 

;Get the divisor into C for conversion 

;from binary to hex 

;Convert the number to hex 

;Perform subroutine for divisor 



;Store the divisor in memory 

;Now we are ready to perform the divide on the numbers entered. 

;Put the divisor back for the §DIV8 SVC 
;Get the dividend into E 
;for the @DIV8 SVC 
;Call the @DIV8 SVC 

;Now display the answer and the remainder in decimal. 

LD (ANSI) ,A ;Store the answer in memory 



i-iU 

LD 


A, (DIVDl) 


LD 


E,A 


LD 


A,@DIV8 


RST 


28H 
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Sample Program B, continued 



00069 
00010 
00011 
00012 
00013 
00014 
00015 
00016 
00011 
0001% 
00019 
00080 
00081 
00082 
0008 3 
0008 4 
00085 
00086 
00087 
00088 
00089 
00090 
00091 
00092 
00093 
00094 
00095 
00096 
00097 
00098 
00099 
00100 
00101 
00102 
00103 
00104 
00105 
00106 
00107 
00108 
00109 
00110 
00111 
00112 
00113 
00114 
00115 
00116 
00117 
00118 
00119 
00120 
00121 
00122 
00123 

0012 4 
00125 
00126 
00127 
00128 
00129 
00130 
00131 
00132 

0013 3 
00134 
00135 



LD 


A,E 


LD 


(REM1) ,A 


LD 


HL,MESS3 


CALL 


DSPLAY 


LD 


A, (ANSI) 


LD 


L,A 


LD 


H,0 


CALL 


HEXDEC 


LD 


HL,MESS4 


CALL 


DSPLAY 


LD 


A, (REM1) 


LD 


L,A 


LD 


H,0 


CALL 


HEXDEC 



Get the remainder 

Store the remainder in memory 

Load address of answer message 

Display the message 

Get the answer into L for conversion 

Number to convert 

Put a in the MSB 

Perform subroutine to display decimal value 

Address of remainder message 

Display remainder message 

Put remainder in A for hex conversion 

Number to convert 

Put in the MSB 

Display decimal value 



;Now divide with a 16-bit dividend. 



LD 


HL,MESS6 


CALL 


DSPLAY 


LD 


A,§KEYIN 


LD 


HL,BUF6 


LD 


B,NUM5 


LD 


C,0 


RST 


28H 


LD 


A,@DECHEX 


RST 


28H 


LD 


(DIVD2) ,BC 


LD 


HL,MESS9 


CALL 


DSPLAY 


LD 


DE, (DIVD2) 


CALL 


HEX16 


CALL 


KEY IN 


LD 


A,C 


LD 


(DIVRl) ,A 


LD 


HL,MESS3 


CALL 


DSPLAY 


LD 


HL, (DIVD2) 


LD 


A, (DIVRl) 


LD 


C,A 


LD 


A,@DIV16 


RST 


28H 


LD 


(REM1) ,A 


LD 


(ANS2) ,HL 


CALL 


HEXDEC 


LD 


HL,MESS4 


CALL 


DSPLAY 


LD 


A, (REM1) 


LD 


L,A 


LD 


H,0 


CALL 


HEXDEC 



;Address of 2nd dividend message 

;Display next message 

;Key in up to 5 digits 

; Store the number 

; Maximum length of number 



;Convert the number to binary 

; Store the dividend 

;Address of hex message 

;Display hex message 

;Put dividend into DE for conversion 

;Convert the number from binary to hex 

;Key in divisor 

;Put the divisor into A 

;Store the divisor in memory 

; Address of answer message 

;Display the message 

;Put dividend into HL 

;Get divisor into C 



; Store the remainder 

;Put the answer into HL 

;Display answer in decimal 

;Address of remainder message 

;Display remainder message 

;Get the remainder 

;into L 

;Put a in MSB 

;Convert the remainder to decimal 



;Now try some multiplication of 8 bits. 



LD 

CALL 

LD 

LD 

LD 

LD 

RST 

LD 

RST 

LD 

LD 

CALL 

LD 

LD 



HL,MESS8 

DSPLAY 

A,@KEYIN 

HL,BUF2 

B,NUM2 

C,0 

28H 

A,@DECHEX 

28H 

(MCANDl) ,BC 

HL,MESS10 

DSPLAY 

A,@KEYIN 

HL,BUF2 



; Address of MUL8 message 

;Display first multiplicand message 

;Key in a 2-digit number 

;Put it here 

;Maximum number of characters 



;Convert the number to binary for math 

;Store the multiplicand 

;Address of MUL8 multiplier message 

;Display first multiplier message 

;Key in the multiplier 

;Put it here 
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Sample Program B, continued 



00136 
00137 
00138 
00139 
00140 
00141 
00142 
00143 
00144 
00145 
00146 
00147 
00148 
00149 
00150 
00151 
00152 
00153 
00154 
00155 
00156 
00157 
00158 
00159 
00160 
00161 
00162 
00163 
00164 
00165 
00166 
00167 
00168 

0016 9 
00170 
00171 
00172 

0017 3 
00174 
00175 
00176 
00177 
00178 
00179 
00180 
00181 
00182 
00183 
00184 
00185 
00186 
00187 
00188 
00189 
00190 
00.191 
00192 
00193 
00194 
00195 
00196 
00197 
00198 
00199 
00200 
00201 
00202 
00203 



LD 


B,NDM1 


LD 


C,J0 


RST 


28H 


LD 


A,§DECHEX 


RST 


28H 


LD 


(MIERl) ,BC 


LD 


HL,MESS13 


LD 


A,@DSPLY 


RST 


28H 



LD 


A, (MCANDl) 


LD 


C, A 


LD 


A, (MIERl) 


LD 


E,A 


LD 


A,@MUL8 


RST 


28H 


LD 


L,A 


LD 


H,0 


CALL 


HEXDEC 



; Maximum number of characters 



;Convert the multiplier to binary for math 

;Store multiplier in memory 
;Address of multiplier message 
;Display multiplier message 



;Now multiply the two numbers just entered. 

;Get the multiplicand into C 
;Get the multiplier into E 



;Put the product into L 

;Put in the MSB 

[Convert the product to decimal 



;Now multiply a 16-bit by an 8-bit. 



;Address of multiplicand message 

;Display 2nd multiplicand message 

;Enter larger multiplicand 

;Put it here 

[Maximum number of characters 



;Convert the number to binary for math 

;Store the multiplicand in memory 

;Address of multiplier message 

;Display message 

;Enter larger multiplier 

;Put it here 

; Maximum number of characters 



[Convert the number to binary for math 

rStore the multiplier in memory 
;Address of product message 
[Display the message 

[Put multiplicand into HL 
[Get the multiplier into C 

[Multiply the two numbers 

;Get the 2nd byte of the product into 
;H for conversion 

[Get the LSB into L for conversion 
[Convert the high-order byte to decimal 
[for the display 

;Tell the display when to stop 



; Display the product 

;Address of end message 
[Display end message 

[Allow the user to enter any character 
;or hit <BREAK> 



LD 


HL,MESS11 


CALL 


DSPLAY 


LD 


A,@KEYIN 


LD 


HL,BUF5 


LD 


B,NUM4 


LD 


C,0 


RST 


28H 


LD 


A,@DECHEX 


RST 


28H 


LD 


(MCAND2) ,BC 


LD 


HL,MESS12 


CALL 


DSPLAY 


LD 


A,@KEYIN 


LD 


HL,BUF3 


LD 


B,NUM2 


LD 


C,J0 


RST 


28H 


LD 


A,@DECHEX 


RST 


28H 


LD 


(MIERl) ,BC 


LD 


HL, MESS 13 


LD 


A,@DSPLY 


RST 


28H 


LD 


HL, (MCAND2) 


LD 


A, (MIERl) 


LD 


C,A 


LD 


A,@MUL16 


RST 


28H 


LD 


H,L 


LD 


L,A 


LD 


DE,BUF5 


LD 


A,@HEXDEC 


RST 


28H 


LD 


A,CCC 


LD 


(DE) ,A 


LD 


HL,BUF5 


LD 


A,@DSPLY 


RST 


28H 


LD 


HL,MESS14 


LD 


A,@DSPLY 


RST 


28H 


LD 


A,@KEY 


RST 


28H 
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Sample Program B, continued 



00204 
00205 
00206 
00207 
00208 
00209 
00210 
00211 
00212 
00213 
00214 
00215 
00216 
00217 
00218 
00219 
002 20 
00221 
00222 
002 2 3 
00224 
00225 
00226 
00227 
00228 
00229 
00230 
00231 
00232 
00233 
00234 
00235 
002 36 
00237 
00238 
002 39 
002 40 
002 41 
00242 
002 43 
00244 
00245 
00246 
00247 
002 48 
00249 
00250 
00251 
00252 

0025 3 
00254 
00255 
00256 
00257 
00258 
00259 
00260 
00261 
00262 

0026 3 
00264 
00265 
00266 
00267 
00268 
00269 
00270 
00271 



CP 


BRK 


JP 


NZ, START 


LD 


A,@EXIT 


RST 


28H 



;Is it <BREAK>? 

;Yes, go back to beginning 

;No, exit the program 



;These are the subroutines used by the calls to 

;display a message, key in a 3-digit number, and convert it 

;from decimal to binary. 



KEYIN: LD 

CALL 

LD 

LD 

LD 

LD 

RST 

LD 

RST 

RET 



HL,MESS1 

DSPLAY 

HL,BUF4 

B,NUM3 

C,0 

A,@KEYIN 

28H 

A,@DECHEX 

28H 



;Display message 
;Put the number here 
;Maximum number of characters 



;Key in a number 
;Convert the number to binary 
; Return to next sequential instruction 
;Display what was loaded into HL before the call. 

;@DISPLAY SVC 



DSPLAY: LD 
RST 
DEC 
LD 

DSPLYLP:LD 
LD 
RST 
DJNZ 
RET 



A,@DSPLY 

28H 

HL 

B, (HL) 

C ' ' 

A,@DSP 

28H 

DSPLYLP 



;Convert 1 byte to hexadecimal. 



HEX8: 



LD 


A,@HEX8 


LD 


HL,BUF3 


RST 


28H 


LD 


A,CCC 


LD 


(HL) ,A 


LD 


A,@DSPLY 


LD 


HL,BUF3 


RST 


28H 


RET 





;Set HL back to blank byte 

;Load B with the number of bytes 

;Put a blank into C 

;Display the blank 

; until the correct number 

;of blanks have been displayed 

;Return to next instruction 



,-Convert 1 byte to hex ASCII 
;Put the converted value here 

;Tell display when to stop 
;Put CCC at end of buffer 
;Display the hex value 



; Return to next instruction 



;Convert 2 bytes to hexadecimal. 



HEX16: LD 
LD 
RST 
LD 
LD 
LD 
LD 
RST 
RET 



A,@HEX16 

HL,BUF6 

28H 

A, CCC 

(HL) ,A 

A,@DSPLY 

HL,BUF6 

28H 



;Convert a 2-byte number to hex ASCII 
;Put the converted value here 

;CCC at end of buffer so display 
; knows when to stop 
;Display the converted value 
;Address of converted value 



; Return to next instruction 
;Convert from binary to decimal and display decimal value. 



HEXDEC: LD 
LD 
RST 
LD 
LD 
LD 
LD 
RST 
RET 



A,@HEXDEC 

DE,BUF5 

28H 

A, CCC 

(DE) ,A 

A,@DSPLY 

HL,BUF5 

28H 



;Convert from binary to decimal 
;Put converted value here 

;CCC at end of buffer so display 
;knows when to stop 
;Display the hex value 
;It's here 

; Return to next instruction 
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Sample Program B, continued 



00272 

00273 

00274 

00275 

00276 

00277 

00278 

00279 

00280 

00281 

00282 

00283 

00284 

00285 

00286 

00287 

00288 

00289 

00290 

00291 

00292 

00293 

00294 

00295 

00296 

00297 

00298 

00299 

00300 

00301 

00302 

00303 

00304 

00305 

00306 

00307 

00308 

00309 

00310 

00311 

00312 

00313 

00314 

00315 

00316 

00317 

00318 

00319 

00320 

00321 

00322 

00323 



;These are the storage declarations. 



BUF6: 

BUF5 

BUF4: 

BUF3: 

BUF2: 

DIVRl: 

DIVD1: 

ANSI: 

REM1: 

MCANDl: 

MIERl: 

MCAND2: 

DIVD2: 

ANS2: 



DEFS 
DEFS 
DEFS 
DEFS 
DEFS 
DEFB 
DEFB 
DEFB 
DEFB 
DEFB 
DEFB 
DEFW 
DEFW 
DEFW 








;Below are messages and prompting text used in the program. 
MESS1: 



MESS 3: 

MESS 4: 

MESS6: 

MESS8: 

MESS9: 

MESS 10: 

MESS11: 

MESS12 
MESS 13 
MESS 14 



DEFB 

DEFM 

DEFB 

DEFB 

DEFM 

DEFB 

DEFB 

DEFM 

DEFB 

DEFB 

DEFM 

DEFB 

DEFB 

DEFM 

DEFB 

DEFB 

DEFM 

DEFB 

DEFB 

DEFM 

DEFB 

DEFB 

DEFM 

DEFB 

DEFB 

DEFM 

DEFB 

DEFM 

DEFB 

DEFM 

DEFB 

END 



13 ;Number of blanks to print after message 1 

'Enter a number (1-255).' 

3 ;Message-terminating character 

21 ; Number of blanks to print after message 3 

'The answer is' 

3 terminating character 

18 ;Blanks after message 

'The remainder is' 

3 terminating character 

6 ;Blanks after message 

'Enter a number (4369-65535).' 

3 ;Terminating character 

15 ;Blanks after message 
'Enter a number (1-28).' 

3 terminating character 

16 ;Blanks after message 
•in hex ASCII, that is' 

3 terminating character 

17 ;Blanks after message 
'Enter a number (1-9). 

3 terminating character 

11 ;Blanks after message 

'Enter a number (1-4100).' 

3 terminating character 

15 ;Blanks after message 

'Enter a number (1-15).' 

3 ;Terminating character 

'The product of those 2 numbers is ' 

3 terminating character 

'Press <BREAK> to- end or any other key to continue.' 

0DH ,-Terminating character 

START 
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Sample Program C 



Ln # 

00001 

00002 

00003 

00004 

00005 

130006 

00008 

00009 

00010 

00011 

00012 

00013 

00014 

00015 

00016 

00017 

00018 

00019 

00020 

00021 

0002 2 

00023 

0002 4 

00025 

00026 

00027 

00028 

00029 

00030 

00031 

00032 

00033 

00034 

00035 

00036 

00037 

00038 

00039 

00040 

00041 

00042 

00043 

00044 

00045 

00046 

00047 

00048 

00049 

00050 

00051 

00052 

0005 3 

0005 4 

0005 5 

00056 

00057 

0005 8 

0005 9 
00060 
00061 
00062 

0006 3 
0006 4 
00065 
0006 6 
0006 7 



Source Line 



This program prompts for two filenames, opens the first 
file, and creates the second. Then the data in the first 
file is copied to the second file. While the Copy progresses, 
the current record number is displayed in parentheses. 



PSECT 3000H 



;This program starts at x'3000' 



First, declare the equates for the SVCs we intend to use. 

This is not mandatory, but it makes the program easier to follow. 



@CLOSE: 

@DIRRD: 

@DSP: 

iDSPLY: 

@ ERROR: 

@EXIT: 

@FEXT: 

@FNAME: 

@FSPEC: 

@HEXDEC 

@INIT: 

@KBD: 

§KEYIN: 

@LOC: 

@OPEN: 

@READ: 

@REMOV: 

@VER: 



BEGIN: 



JP 



EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
:EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 



60 

87 

2 

10 

26 

22 

79 

80 

78 

97 

58 

8 

9 

63 

59 

67 

57 

73 



;Close a file or device 

;Read a directory record 

;Display character at cursor 

;Display a message 

;Display an error message 

;Exit and return to TRSDOS or the caller 

;Add a default file extension 

;Fetch a filespec from the directory 

;Verify and load a filespec into the FCB 

;Convert a binary value to decimal ASCII 

;Open an existing file or create a new file 

;Scan the keyboard for a character 

;Accept a line of text from the *KI device 

;Return the current logical record number 

;Open an existing file 

;Read a record from an open file 

?Delete a file from disk 

;Write a record to disk. Does the same thing 

;as @WRITE (Svc 75), but it also makes sure 

;the written data is readable. 



LD 


HL,MESG1 


LD 


A,@DSPLY 


RST 


28H 



First, prompt for the source filespec using the @DSPLY svc. 

;Get the first message 
;Display a line on the screen 
;Call the @DSPLY svc 

Now, read the filename from the keyboard using the @KEYIN svc. 

;Put the name of the 1st file here 

;Allow up to 24 characters 

;A zero is required by the svc 

;Get a filename from the user 

;Call the §KEYIN svc 

;The user pressed <Break> 

;An Error occurred 

;Get the number of characters 
;See if that value was zero 
.•Nothing was entered, ask again 

The user has typed something, so it must be checked for validity 
using the @FSPEC svc. 



LD 


HL,FILE1 


LD 


B,24 


LD 


C,0 


LD 


A,@KEYIN 


RST 


28H 


CQUIT 




JP 


NZ,ERR 


LD 


A,B 


OR 


A 


JR 


Z, BEGIN 



LD 
LD 

LD 



RST 
JR 



HL,FILE1 
DE,FCB1 

A,@FSPEC 



28H 
Z,ASK2 



; Point at the text the user entered 

;Point at the File Control Block 

;that is to be used for the source file. 

;The @FSPEC svc will make sure the filename 

;that is in buffer named "filel" is valid. 

;If it is, it is copied into the File 

;Control Block (FCB) to be used by the ©OPEN 

;or #INIT svc later on. 

?Call the @FSPEC svc 

;The name for file 1 is ok, so skip this 



At this point the filename specified for file 1 has been found 
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Sample Program C, continued 



00068 

0006 9 

00070 

00011 

00012 

00013 

0001 4 

00015 

00016 

00011 

00078 

00019 

00080 

00081 

00082 

00083 

00084 

00085 

00086 

00087 

00088 

00089 

00090 

00091 

00092 

00093 

00094 

00095 

00096 

00097 

00098 

00099 

00100 

00101 

00102 

00103 

00104 

00105 

00106 

00101 

00108 

00109 

00110 

00111 

00112 

00113 

00114 

00115 

00116 

00117 

00118 

00119 

00120 

00121 

00122 

0012 3 

00124 

00125 

00126 

00127 

00128 

00129 

00130 

00131 

00132 

00133 

00134 

00135 



F20K: 



FDIV: 



LD 


HL,BADFIL 


LD 


A,@DSPLY 


RST 


28H 


JR 


BEGIN 



LD 


HL,MESG2 


LD 


A,@DSPLY 


RST 


28H 


LD 


HL,FILE2 


LD 


B,24 


LD 


C,0 


LD 


A,@KEYIN 


RST 


28H 


JP 


CQUIT 


JP 


NZ,ERR 


LD 


A,B 


OR 


A 


JR 


Z,ASK2 



to be in an invalid format. The following code will print the 
error message. 

;Point at the bad filename message 

;Display it 

;Call the @DSPLY svc 

; Start over 

At this point, the source filename appears to be valid. 

The code below asks for the second filename and checks it for 

validity also. 

ASK2: LD HL,MESG2 ;Prompt for the target filename 

;Print that on the screen 
;Call the @DSPLY svc 
;Put the name of the 2nd file here 
;Allow up to 24 characters 
;A zero is required by the svc 
;Get a filename from the user 
;Call the @KEYIN svc 
;The user pressed <Break> 
;An Error occurred 

;Get the number of characters 
;See if that value was zero. 
;Nothing was entered, ask again 

The user has typed something, so it must be checked for validity 
using the @FSPEC svc. 

; Point at the text the user entered 

;Point at the File Control Block 

;Check the name for validity 

;Call the @FSPEC svc 

;The name for file 2 is ok, so skip this 

The name for file 2 is invalid so print an error message 

; Point at the bad filename message 

;Display it 

;Call the @DSPLY svc 

;Start over 

Now we will attempt to add an extension to the target file 

if the user did not specify one. We use the extension that 

was specified on the source file. If it does 

not have one, then we will not try to add one to the target file. 

;Point at the source filename 

;We start with the second character since 

;the filename must be at least one character 

;Get a character from the filespec 

;Is the character the extension prefix? 

;Yes, this will be our default extension 

;Have we reached the end of the filespec? 

;Yes, there is no extension so don't add one 

;Test both terminators 

;Advance the pointer to the next character 
;Keep looking 

EXTN: INC HL ;Advance pointer to first byte of extension 

;Point at FCB for the target file (file 2) 
;Add an extension if one is not present 
;Call the @FEXT svc 



LD 


HL,FILE2 


LD 


DE,FCB2 


LD 


A,§FSPEC 


RST 


28H 


JR 


Z,F20K 



LD 


HL,BADFIL 


LD 


A,@DSPLY 


RST 


28H 


JR 


BEGIN 



LD 


HL,FCB1+1 


LD 


A, (HL) 


CP 


'/' 


JR 


Z,EXTN 


CP 


0DH 


JR 


Z , NOEXT 


CP 


03H 


JR 


Z, NOEXT 


INC 


HL 


JR 


FDIV 


INC 


HL 


LD 


DE,FCB2 


LD 


A,@FEXT 


RST 


28H 



Now we have two filenames, 
to make sure it exists. 



First we will open the source file 
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Sample Program C 9 continued 



00136 

00137 

00138 

0013 9 

00140 

00141 

00142 

00143 

00144 

00145 

00146 

00147 

00148 

00149 

00150 

00151 

00152 

0015 3 

0015 4 

00155 

00156 

00157 

00158 

0015 9 

00160 

00161 

00162 

00163 

00164 

00165 

00166 

00167 

00168 

00169 

00170 

00171 

00172 

0017 3 
00174 
00175 
00176 
00177 
00178 
00179 
00180 
00181 
00182 
00183 

0018 4 
00185 
00186 
00187 
00188 
0018 9 
00190 
00191 
00192 
00193 
00194 
00195 
00196 
00197 
00198 
00199 
00200 
00201 
00202 
00203 



NOEXT : 



SIZ: 



WAIT: 



LD 
LD 



DE,FCB1 
HL,BUF1 



LD 



B,0 



LD 


A,80PE 


RST 


28H 


JR 


Z,SIZ 


CP 


42 


JP 


NZ,ERR 



;Point at the File Control Block for filel 

; Point at the system buffer. This buffer 

;is used by the system to block data that 

;is written to disk and de-block data that 

;is read from disk when the Logical Record 

;Length of the file is not 256. If it is 

;256, then this buffer is not used. 

;Use LRL 256 for now since we don't know 

;what to use yet. 

;Open the file 

;Call the @OPEN svc 

;The file opened and is LRL 256. 

;Was the error a LRL Open Fault? 

;No, perhaps the file does not exist. 

At this point, the file is open and we can now examine the 
directory to find out what LRL it was created with so we can 
use that value to make the copy. 

;Get the byte in the FCB which contains 

;the drive number the file is on 

;Erase all other information in that byte 

;Save that value here 

;This reads the Directory Entry Code (DEC) 

;out of the FCB so we can use it 

; Store the DEC here 

;Save that value for now 

;We can close the source file for now 

;Call the @CLOSE svc 



LD 


A, (FCBl+6) 


AND 


7 


LD 


C,A 


LD 


A, (FCB1+7) 


LD 


B,A 


PUSH 


BC 


LD 


A,@CLOSE 


RST 


28H 



POP BC 

LD A,@DIRRD 

RST 28H 



LD 
LD 

LD 



IX / HL 
A, (IX+4) 

(LRL) ,A 



;Get the DEC value back off the stack 
;Read the directory record for that file 
;Call the @DIRRD svc 

;Put the pointer to the directory record 
;here and read the DIR+4 entry which 
;contains the LRL of the source file. 
;Save that value 



Before we go any further, we should check to see if the target file 
already exists. 



LD 
LD 
LD 
LDIR 

LD 

LD 

LD 

LD 

RST 

JR 

CP 

JR 

EXISTS: LD 

LD 
RST 



LD 

RST 

JR 

CP 
JR 



DE,COPY 
HL,FCB2 
BC,32 



DE,FCB2 

HL,BUF2 

B,0 

A,@OPEN 

28H 

Z, EXISTS 

42 

NZ,NOFILE 

HL,FEXST 

A,@DSPLY 
28H 

A,@KBD 

28H 

NZ,WAIT 

lyl 

Z,KILLIT 



; First, make a copy of the FCB 
;in case we have to delete a file 
;Move the entire block 



; Point at the target File Control Block 

;Use this as the buffer for now 

;Use LRL 25 6 for now 

;Open it and see if it is there 

;Call the @OPEN svc 

;The file already exists, better ask 

;Was the error a LRL mismatch? 

;No, so the file does not exist. 

; Point at a prompt asking if it is ok 
;to erase the file that already exists 
;Print that message 
;Call the @DSPLY svc 

;Wait for the user to type Y or N 

;Call the §KBD svc 

;Loop until something is typed 

;Was a 'Y' typed? 
;Then kill the file 
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Sample Program C, continued 



00204 
00205 
0020% 
00201 
00208 
00209 
00210 
00211 
00212 
00213 
00214 
00215 
00216 
00217 
00218 
00219 
00220 
00221 
00222 
00223 
002 2 4 
00225 
00226 
00227 
00228 
002 2 9 
00230 
00231 
002 32 
002 33 
00234 
00235 
002 36 
00237 
00238 
00239 
00240 
00241 
00242 
00243 
00244 
00245 
00246 
00247 
00248 
00249 
00250 
00251 
00252 
00253 
00254 
00255 
00256 
00257 
00258 
00259 
00260 
00261 
00262 
00263 
00264 
00265 
00266 
00267 
00268 
00269 
00270 



SHUT: 



KX Li LX i ; 



LRL256: 



;Check for lowercase too 

;Do they want to leave the file alone? 

;No, just close the file and quit 

;Was it a lowercase 'N'? 

;No, loop until we see something we like 

;Close the target file 

;Call the ©CLOSE svc 
;Exit to TRSDOS 

At this point, we have been given the OK to delete the file 
that has the same name as the target file. 



CP 


-y- 


JR 


Z,KILLIT 


CP 


>N' 


JR 


Z,SHUT 


CP 


■n' 


JR 


NZ,WAIT 


LD 


DE,FCB2 


LD 


A,@CLOSE 


RST 


28H 


JP 


QUIT 



LD 
LD 
RST 

LD 
LD 
RST 

JP 



C0DH 

A,@DSP 

28H 

DE,FCB2 

A,@REMOV 

28H 

NZ,ERR 



;First move display to a new line 
;Display an <Enter> 
;Call the @DSP svc 

Point at the target file's FCB 

Delete the file from disk 

Call the @REMOV svc. (This is the same 

as the SKILL call on other TRSDOS systems.) 

An error occurred, print it and quit 

Note that after a @REMOV succeeds, 

the filespec is removed from the FCB. 

So we have to keep a copy around 

in case we need it. 

Get the copy 

Put it here 

Move up to 32 bytes 

Copy the FCB so we can continue 

Now we know what Logical Record Length (LRL) to use in the 
copy, so we can open the source file and create the target file 
with the correct record lengths. 



LD 


HL,COPY 


LD 


DE,FCB2 


LD 


BC,32 


LDIR 





NOFILE: LD 
LD 
RST 
LD 
LD 
RST 

LD 

LD 

LD 

LD 

LD 

RST 

JP 



LD 
LD 
RST 

LD 
LD 
CP 
JR 
LD 
JR 
LD 



LRLCOM: LD 
LD 



HL,FCB1 

A,@DSPLY 

28H 

HL, SPACES 

A,@DSPLY 

28H 

DE,FCB1 

HL,BUF1 

A, (LRL) 

B,A 

A,@OPEN 

28H 

NZ,ERR 

HL, ARROW 
A,@DSPLY 
28H 

DE,FCB2 

A, (LRL) 



Z,LRL256 

HL,BUF2 

LRLCOM 

HL,BUF1 



B,A 
A,@INIT 



;Point at the filename in the FCB 

; Print that name 

;Call the @DSPLY svc 

; Point at some spaces 

;Space over a few places on the screen 

;Call the @DSPLY svc 

;Point at File Control Block for source file 

;Put data in this 

;Read the Logical Record Length 

;Load the Logical Record Length 

;Open the source file 

;Call the @OPEN svc 

;Open failed 

;Point at the arrow text 

;Print that to show the direction of copy 

;Call the §DSPLY svc 

;Point at File Control Block for target file 

;Get the Logical Record Length 

;Is the LRL 256? 

;Then we do something special 

;Use a different buffer for target file 

;Jump to common code 

;We use the same buffer when the LRL is 256 

;since there is no need to block and de-block 

;the data. 

;Load the Logical Record Length 

;Open the target file 
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Sample Program C, continued 



00271 
00272 
002 7 3 
002 7 4 
00275 
00276 
00277 
00278 
002 7 9 
00280 
00281 
00282 
002 8 3 
00284 
00285 
00286 
00287 
00288 
00289 
00290 
00291 
002 92 
002 93 
002 94 
00295 

002 96 
00297 
00298 
00299 
00300 
00301 
00302 
00303 
00304 
00305 
00306 
00307 
00308 
00309 
00310 
00311 
00312 
00313 
00314 
00315 
00316 
00317 
00318 
00319 
00320 
00321 
00322 
00323 
00324 
00325 
00326 
00327 
00328 
00329 
00330 
00331 
00332 

003 33 
00334 
00335 
003 36 
003 37 
00338 



RST 


28H 


JR 


NZ,ERR 


LD 


DE,FILE2 



LOOP: 



EDIT: 



NUMBR : 



LD 


A, (FCB2+7) 


LD 


B,A 


LD 


A, (FCB2 + 6) 


AND 


7 


LD 


C,A 


LD 


A,@FNAME 


RST 


28H 


LD 


HL,FILE2 


LD 


A,@DSPLY 


RST 


28H 


LD 


HL, SPACES 


LD 


A,@DSPLY 


RST 


28H 



;Call the @INIT svc 
;Init failed 

We are going to get the filename for 

the target file from the system 

instead of using the one we have. The 

reason for this is that the system will 

append the drive number to the filename 

if one was not specified. 

Get the Directory Entry Code for the file 

Put. the DEC here 

Get the Drive Number from the FCB 

Lose all data except the drive number 

Store drive number here 

Have the system produce a filespec 

Call the @FNAME svc 

Now point at the filespec produced 

and print it out 

Call the @DSPLY svc 

; Space over a few more places 
;so the display will look neat 
;Call the @DSPLY svc 

At this point, both files are open and ready to be used. 
The following code reads a record from the source file 
and writes it to the target file. This is done until an 
end of file is encountered. 

;Point at file 1 (source file) 

;Put data here 

;Read a record from the source file 

,-Call the @READ svc 

;Jump if the eof has been reached 

;Point at file 2 (target file) 

Before writing the record, display the record number, which 
is obtained from the @LOC svc. 

LD A,@LOC ;Get the current record number 

RST 28H ;Call the @LOC svc 

PUSH BC ;Get the current record number- 
POP HL ;and put it in register HL 
LD DE,L0CMSG+1 ; Store the result here. 

LD A,@HEXDEC ;Convert binary to ASCII in decimal format 

RST 28H ;Call the QHEXDEC svc 

LD A, ' ' ;Get a blank 

LD HL,LOCMSG ;Look at the front of the buffer 

CP (HL) ;ls the character a blank? 

JR NZ, NUMBR ;A number has been found 

INC HL ; Advance the pointer 

JR EDIT ;Loop until we find a number 

DEC HL ;Back up one position 

LD A, ' ( ' ;Get the character we want to insert 

LD (HL) ,A ;Store that character. 

;The buffer now contains 

;<none or more spaces> ( record number) 

;<7 left-cursor characters><etx> 

;Point at this text 

;and display it on the screen 

;Call the @DSPLY svc 

Now write the record to the target file. 

LD DE,FCB2 ; Point at the FCB for the target file 



LD 


DE,FCB1 


LD 


HL, BUFFER 


LD 


A, @ RE AD 


RST 


28H 


JR 


NZ,EOF 


LD 


DE,FCB2 



LD 


HL,LOCMSG 


LD 


A,@DSPLY 


RST 


28H 
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Sample Program C 5 continued 



00339 

003 40 

00341 

00342 

00343 

00344 

00345 

00346 

00347 

00348 

00349 

00350 

00351 

00352 

00353 

00354 

00355 

00356 

00357 

00358 

00359 

00360 

00361 

00362 

0036 3 

00364 

00365 

00366 

00367 

00368 

003 6 9 

00370 

00371 

00372 

00373 

00374 

00375 

00376 

00377 

00378 

00379 

00380 

00381 

00382 

00383 

00384 

00385 

00386 

00387 

00388 

00389 

00390 

00391 

00392 

00393 

00394 

00395 

00396 

00397 

00398 

00399 

00400 

00401 

00402 

00403 

00404 

00405 



EOF: 



QUIT: 



ERR: 



SPACES: 
ARROW : 
OK: 

MESG1: 

MESG2: 

FEXST: 

BADFIL: 

LOCMSG: 



LD 
LD 



RST 
JR 

JR 



HL , BUFFER 
A,@VER 



28H 
NZ,ERR 

LOOP 



;Point at the data read from file 1 

;Write a record to the target file 

;The @VER does the same thing as the 

;@WRITE svc, only it also checks the 

;data to make sure it is readable. 

;Call the @VER svc 

;An error occurred on write; possibly 

;the disk is full. 

;Loop until an error occurs. 



This code checks the error to make sure it was an end of file 
condition and, if so, closes the source & target files. 

;Was it an end of file encountered? 

;It was some other type of error - Abort 

; Point at file 1 (source file) 

;Close the file 

;Call the OCLOSE svc 

;An error occurred, abort 

;Point at file 2 (target file) 

;Close it also 

;Call the (3CL0SE svc 

;An error occurred, abort 

;Print a message saying the copy is done 

;Call the §DSPLY svc 

;Exit to TRSDOS or the calling program 
;Call the @EXIT svc 

The @EXIT svc does not return. 

OR 040H ;Turn on bit 6, which 

;will cause the @ERROR svc to print 

;the short error message. Bit 7 

;is not set, which instructs the @ERROR 

;to abort this program and return to 

; TRSDOS Ready. 

;Put error code & flags in register C 

;Call the system error displayer 

;Call the @ERROR svc 

Because bit 7 is not set, the @ERROR svc will not return. 

Storage Declaration 

;ASCII Space characters for display formatting 
;Arrow for display to indicate data direction 



CP 


28 


JR 


NZ,ERR 


LD 


DE,FCB1 


LD 


A, ©CLOSE 


RST 


28H 


JR 


NZ,ERR 


LD 


DE,FCB2 


LD 


A,@CLOSE 


RST 


28H 


JR 


NZ,ERR 


LD 


HL,OK 


LD 


A,@DSPLY 


RST 


28H 


LD 


A,@EXIT 


RST 


28H 



LD 


C,A 


LD 


A, @ ERROR 


RST 


28H 



DEFM 
DEFB 
DEFM 
DEFB 
DEFB 
DEFM 
DEFB 
DEFM 
DEFB 
DEFM 
DEFB 
DEFM 
DEFB 
DEFM 
DEFB 
DEFM 

DEFB 



;Advance cursor 10 spaces without erasing 
;Used to indicate the Copy is complete 
;Terminated with an <Enter> 



'=> ' 

3 

10%25 

'[Ok] ' 

0DH 

'Copy Filespec >' 

3 

'To Filespec >' 

3 

'Destination File Already Exists - Ok to Delete it (Y/N) ?' 

3 

'Invalid Filename - Try Again' 

0DH 

' 12345)' ;This will be used in building the LOC 

;display which will appear as (d) to (ddddd) . 
7%24 ;Backspace without erasing 
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Sample Program C 9 continued 



00406 




DEFB 


3 


00401 








00408 


PILEl: 


DEFS 


32 


00409 


FILE2: 


DEFS 


32 


00410 


FCBl: 


DEFS 


32 


00411 


FCB2 : 


DEFS 


32 


00412 


COPY: 


DEFS 


32 


00413 


LRL: 


DEFB 





00414 








00415 


BUFl: 


DEFS 


256 


00416 


BUF2: 


DEFS 


256 


00417 


BUFFER: 


DEFS 


256 


00418 








00419 




END 


BEG 



;Etx, used to get the @DSPLY svc to stop 

;User Text Originally placed here 

;Target Filename goes here 

;32 bytes for the File Control Block 

;32 bytes for the File Control Block 

;An extra copy of the target FCB goes here 

;The Logical Record Length of the source 

;file will be stored here 

;System buffer for File 1 

;System buffer for File 2 

;Data buffer for both files 

; "begin" is the starting address 
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Sample Program D 



Ln # 

00001 
00002 
00003 
00004 
00005 
00006 
00001 
00009 
00010 
00011 
00012 
00013 
0001 A 
00015 
00016 
00017 
00018 
00019 
00020 
00021 
00022 
00023 
0002 4 
00025 
00026 
00027 
00028 

0002 9 
00030 
00031 
00032 
00033 

0003 4 
00035 
0003 6 
00037 
00038 
0003 9 
00040 
00041 
00042 
00043 
00044 
00045 
00046 
00047 
00048 
00049 
00050 
00051 
00052 
0005 3 
0005 4 
00055 
00056 
00057 
00058 
0005 9 



00061 
00062 
0006 3 
0006 4 
0006 5 
0006 6 
00067 



Source Line 

This program will read a sector from the disk in Drive 
and will write it to a disk in Drive 1. The disk in Drive 1 
must be formatted, ' but should not have anything important on 
it. This program makes an assumption that the directory is 
located on cylinder 20 (x'14'). 



PSECT 3000H 



;This program begins at x'3000'. 



Define the equates for the SVCs that will be used. 



@ ABORT: 

dCKDRV: 

@DCSTAT : 

@ ERROR: 

@EXIT: 

@RDSEC: 

@RDSSC: 

@WRSEC: 

@WRSSC: 



SYSSEC: 
USRSEC: 



START: 



EQO 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 



21 
33 
40 
26 
22 
49 
85 
53 
54 



Other Equates 



EQU 
EQU 



1400H 

m 



; Abort and return to TRSDOS 

;Test to see if a drive is ready 

;Verify that a drive is defined in the DCT 

;Display an error message 

;Return to TRSDOS or the calling program 

;Read a sector 

;Read a system sector 

;Write a sector 

;Write a system sector 



;The system sector is Cylinder 20, Sector 
;The regular sector is Cylinder 0, Sector 



First, test the target drive and make sure it is defined. 

;Select Drive 1 

;Ask if the drive is listed in the DCT 

;Call the @DCSTAT svc 

;If NZ, then the drive is not defined 

;and we will abort execution. 

Now, test and make sure the target drive contains a formatted 
disk and is write-enabled . 



LD 


C,l 


LD 


A,@DCSTAT 


RST 


28H 


JR 


NZ, ERROR 



LD C,l 

LD A,@CKDRV 



RST 28H 
LD A, 8 



JR 
LD 



JR 



NZ, ERROR 
A, 15 



C , ERROR 



Select Drive 1 

Test to see if the disk is formatted 

and is write-enabled . Note that the 

disk must be formatted by TRSDOS 6.x 

or by LDOS 5.1.x to be considered 

"formatted" by this svc. 

Call the @CKDRV svc 

This will become the error number if the 

drive was not ready. This is done 

because the @CKDRV svc does not return error 

codes . 

The drive is not ready 

This will become the error number if the 

drive is ready and is write-protected . 

As above, this is done because @CKDRV does 

not return error messages. 

The disk is formatted, but it is 

write-protected. In either case, abort. 



Now that we know the target drive is ready, read a sector 

from the source drive and write it to the target drive (Drive 1) . 

;Select Drive 

;Read the first sector on the disk, 

;Cylinder 0, Sector 0. 

;Point to a buffer which will hold the sector 

;Read a non-system sector 

;Call the @RDSEC svc 

;If NZ, an error occurred, so abort 



LD 


C,0 


LD 


DE, USRSEC 


LD 


HL,BUFF 


LD 


A,@RDSEC 


RST 


28H 


JR 


NZ, ERROR 
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Sample Program D 9 continued 



0006 9 

00070 
00071 
00072 

0007 3 
00074 
00075 
00076 
00077 
00078 
0007 9 



00081 

00082 

00083 

00084 

00085 

00086 

00087 

00088 

00089 

00090 

00091 

00092 

00093 

00094 

00095 

00096 

00097 

00098 

00099 

00100 

00101 

00102 

00103 

00104 

00105 

00106 

00107 

00108 

00109 

00110 

00111 

00112 

00113 

00114 

00115 

00116 

00117 

00118 

00119 

00120 

00121 

00122 

0012 3 

00124 

00125 

00126 

00127 



ERROR : 



BUFF: 



LD 


C,l 


LD 


DE,USRSEC 


LD 


HL,BUFF 


LD 


A,@WRSEC 


RST 


28H 


JR 


NZ, ERROR 



LD 


C,0 


LD 


DE,SYSSEC 


LD 


HL,BUFF 


LD 


A,@RDSSC 


RST 


28H 


JR 


NZ, ERROR 



Now, write the sector to the target drive. 

; Select Drive 1 

;Write the sector to Cylinder 0, Sector 

;on Drive 1 

;Point to the buffer containing the sector 

;Write the sector to disk 

;Call the @WRSEC svc 

;If NZ, an error occurred, so abort 

Now we will read a system sector from Drive and write it on 
drive 1. The difference between a system sector and a non-system 
sector is that the Data Address Marks (DAM) are different. These 
were written to the disk when it was formatted. TRSDOS 6.x uses 
these as an extra check to make sure that a write of user data 
does not accidentally get placed over a sector containing system 
data. All of the sectors in the directory cylinder are marked 
as system sectors. 

;Select Drive 

;Read Cylinder 20, Sector 

; Store the sector at this address 

;Read a system sector 

;Call the @RDSSC svc 

;An error occurred, so abort 

Now write the sector to the target drive as a system sector. 
There is no requirement that a sector must be placed at the 
same cylinder and sector location as it was read from, but 
for simplicity, we are doing that. 

; Select Drive 1 

; Write Cylinder 20, Sector 

;Point to the data to be written 

;Write a system sector 

;Call the @WRSSC svc 

;An error occurred, so abort 

; Return to TRSDOS or the calling program 
;Call the @EXIT svc 

This routine displays an error message if anything goes wrong. 
Note that @CKDRV does not return an error message, so @ERROR 
cannot be used for it without some manipulation. 

;Set bit 7 

;Load error number into register C 
;This will display the error message 
;and return to the calling program 
;Call the @ ERROR svc 

;Now, force an abort. This will return 
;to TRSDOS Ready and will abort any 
;JCL file that is currently executing 
;Call the 8 ABORT svc 

;256-byte buffer to store the sector that 
;is read and then written 



LD 


C,l 


LD 


DE,SYSSEC 


LD 


HL,BUFF 


LD 


A,@WRSSC 


RST 


28H 


JR 


NZ, ERROR 


LD 


A,@EXIT 


RST 


28H 



OR 


0C0H 


LD 


C,A 


LD 


A, @ ERROR 



RST 



LD 



28H 



A, @ ABORT 



RST 28H 
DEFS 256 



END 



START 
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Sample Program E 



Ln # 

00001 

00002 

00003 

00004 

00006 

00001 

00008 

00009 

00010 

00011 

00012 

00013 

00014 

00015 

00016 

00017 

00018 

00019 

00020 

00021 

00022 

00023 

00024 

00025 

00026 

00027 

00028 

00029 

00030 

00031 

00032 

00033 

00034 

00035 

00036 

00037 

00038 

0003 9 

00040 

00041 

00042 

00043 

00044 

00045 

00046 

00047 

00048 

00049 

00050 

00051 

00052 

0005 3 

0005 4 

00055 

00056 

00057 

0005 8 

0005 9 

00060 

00061 

00062 

00063 

00064 

00065 

00066 

00067 



Source Line 

This program displays the filenames of the disk in 
Drive three different ways. 



START : 



DIR0: 



PSECT 3000H 



;Program begins at x'3000' 



First, declare the equates for the SVCs we intend to use. 

This is not mandatory, but it makes the program easier to follow. 



@CMNDI: EQU 
@CMNDR: EQU 
@DODIR: EQU 



24 
25 

34 



; Execute a TRSDOS command and return 

;to TRSDOS Ready 

; Execute a TRSDOS command and return 

;to the calling program 

;Display visible filenames on the 

;specified disk drive 



LD 


HL,DIR0 


LD 


A,@CMNDR 


RST 


28H 



First, pass a "DIR :0" command to the system. TRSDOS will 
execute this command and then return to this program. 

; Point at command we want to execute 
,-Execute the specified command and return 
;Call the @CMNDR svc 

You may have noticed that the DIR displayed the files, but that 
they were not sorted alphabetically. This is because the DIR 
command will not use memory above x'3000' when it is invoked with 
a @CMNDR svc. This prevents the DIR command from performing a 
sort of the filenames. 



Now do a directory command using the @DODIR svc 
B,0 



LD 

LD 
LD 



RST 



C,0 
A,@DODIR 



28H 



;Use Function which displays all 
;visible files in the directory. 
;Put source drive number in register C 
;The filenames will be read from the 
;directory and displayed in the 
;order they appear in the directory. 
;Call the @DODIR svc 



This time 



Now pass a "DIR :0" command to the system. 

the command will be executed and then TRSDOS will not return 

to this program, but will return to TRSDOS Ready. 



LD 
LD 

RST 



HL,DIR0 
A,@CMNDI 

28H 



; Point at the command we want performed 

;and execute it, but don't return to 

;this program. 

;Call the @CMNDI svc 

;This svc returns to TRSDOS Ready. 



Note that when the library command DIR is performed this time, 
the display of files is sorted. This is because DIR determines 
that it was invoked with a @CMNDI svc, and it will not return 
to the calling program. Therefore, DIR is free to use the_ 
memory above x'3000' to perform the sort of the filenames in 
the directory. 



Constants 
DEFM 'DIR :0' 
DEFB 0DH 
END START 



;This command is passed to TRSDOS 

;via the @CMNDR and (3CMNDI SVCs. 

;It must be terminated with an <ENTER> 
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Sample Program F 



Ln # 



Source Line 



00001 
00002 
00003 
00004 
00005 
00006 
00001 
00008 
00009 
00010 
00011 
00012 
00013 
00015 
00016 
00017 
00018 
00019 
00020 
00021 
00022 
0002 3 
0002 4 
00025 
00026 
00027 
00028 

0002 9 
00030 
00031 
00032 
00033 

0003 4 
00035 
00036 
00037 
00038 

0003 9 
00040 
00041 
00042 

0004 3 
00044 
00045 
00046 
00047 
00048 
00049 
00050 
00051 

0005 2 
0005 3 
0005 4 
00055 
0005 6 
0005 7 
00058 

0005 9 
00060 
00061 

0006 2 
0006 3 
0006 4 
0006 5 
00066 
00067 



This program adds 
which displays the 
of times the task 
For simplicity, th 
If it is already i 
slot is this progr 
recover the memory 
If the task slot i 
and the address of 
The first time you 
next time you run 

PSECT 3000H 



to the system task scheduler a task 

date and a running count of the number 
has been executed. 

e program tries to use task slot 0. 
n use, it assumes that the task using that 
am, and it kills the task. It then tries to 

used by the task in high memory, 
s not in use, the task is placed in high memory, 

the task is passed to the task scheduler. 

run this program it adds the task, and the 
this program, it removes the task. 

;This program starts at x'3000' 



First, declare the equates for the SVCs we intend to use. 

This is not mandatory, but it makes the program easier to follow. 



@ADTSK: EQU 

@CKTSK: EQU 

@DATE: EQU 

@DSPLY: EQU 

@EXIT: EQU 

@GTMOD: EQU 
@HEXDEC:EQU 

@HIGH$ : EQU 

@RMTSK: EQU 

dVDCTL: EQU 

@WHERE: EQU 



29 ;Add a task entry to the scheduler 

28 ;Check to see if a task slot is in use 

18 ;Return the date in ASCII format 

10 ;Display a message 

22 ; Return to TRSDOS Ready or the caller 

8 3 ; Locate a memory module 

97 ;Convert a binary value to decimal ASCII 

100 ;Read or modify HIGH$ or LOW$ 

30 ;Remove a task entry from the scheduler 
15 ; Perform video operations 

7 ;Find out where the program counter is 

;when this SVC is executed. This is 
; useful in relocatable code that must 
;make absolute address references to 
;call subroutines or modify data. 



Below we will define a macro to simulate a call relative 
instruction. Since the task must be able to run no matter 
where it is placed, it must use relative jumps and calls. 
The Z80 instruction set has a jump relative (JR) , but does 
not have a call relative instruction. This can be simulated 
using the @WHERE SVC, which returns the address of the caller 
in a register. This address can be adjusted and placed on 
the stack as a return address. Then a jump relative can be used 
to reach the subroutine. 



CALLR : 



MACRO #1 

PUSH HL 

PUSH BC 

PUSH AF 

LD A,@WHERE 

RST 28H 

LD BC, 3+1+1+1+1+2 



ADD HL,BC 

POP AF 

POP BC 

EX (SP),HL 

JR #1 

ENDM 



#1 will be the address you want to call 

Save the registers we damage 

Save it 

Save it 

Get our current address 

Call the SWHERE svc 

Get the lengths of the instructions after 

the SVC. This will allow the subroutine 

to return to the correct address . 

Add that offset to where we are 

Put stack back 

Restore registers 

Put return address on stack and restore HL 

Jump to the subroutine 

End of the macro 



This is the main program. It loads at x'3000'. It decides 
if it needs to add or remove the task in the scheduler tables. 
If it adds the task, it moves a copy to the top of memory and 
protects it, and adds a task entry to the scheduler. 
If it is removing a task, it kills the entry in the scheduler 
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00068 

00069 

00070 

00071 

00072 

00073 

00074 

00075 

00076 

00077 

00078 

00079 

00080 

00081 

00082 

00083 

00084 

00085 

00086 

00087 

00088 

00089 

00090 

00091 

00092 

00093 

00094 

00095 

00096 

00097 

00098 

00099 

00100 

00101 

00102 

00103 

00104 

00105 

00106 

00107 

00108 

00109 

00110 

00111 

00112 

00113 

00114 

00115 

00116 

00117 

00118 

00119 

00120 

00121 

00122 

00123 

00124 

00125 

00126 

00127 

00128 

00129 

00130 

00131 

00132 

00133 

0013 4 

00135 



Sample Program F, continued 

tables, and then attempts to recover the memory used by the task. 

BEGIN: LD C,0 ;First, we will test slot 

LD A,@CKTSK ;to see if anyone is using it 

RST 28H ;Call the @CKTSK svc 

JR NZ,KILLIT ;There is a task using slot 0, kill it 

At this point, we want to add a task to high memory. 
First we find the value for HIGH$ and put a copy of the 
task there. Then we protect the task by moving HIGH$ below 
the new task. 



LD 

LD 

LD 

RST 

LD 



LD 
LD 
LD 

LDDR 



HL,0 

B,H 

A,@HIGH$ 

28H 

(ENDADD) ,HL 



; First, get the value of HIGH$ 
;Read HIGH$ 

;Call the @HIGH$ svc 

;Save this value as the last address 
;that the task will be stored in once it 
;is moved to high memory 



DE,HL ;Put that value here 

HL,M0DEND~1 ; Point at the end of the module 
BC,MODEND-MODULE;Move the module from where it is 

; right now to a position below HIGH$ 

;Do the copy 

;Now protect the module using HIGH$ 
; Update HIGH$ 



LD 


HL,DE 


LD 


B,0 


LD 


A,@HIGH$ 


RST 


28H 



;Call the @HIGH$ svc 

Now we need to load the TCB entry in the module with the address 
of the first instruction to be executed. 

LD IX, HL ;IX now points at memory header 

LD BC,ENTRY-M0DULE+1 ;Get the offset into the module 

;of the first instruction 
ADD HL,BC ;HL now contains the actual starting address 

LD (IX+(1+M0DTCB-M0DULE) ) ,L ;Store LSB of the address 
LD (IX+1+(1+M0DTCB-M0DULE)) ,H ;Store MSB of the address 

Now the task is ready to run. We now add the entry to the task 
scheduler table. 



LD 



BC , MODTCB-MODOLE+1 



PUSH 


IX 


POP 


HL 


ADD 


HL,BC 


LD 


DE,HL 


LD 


C,0 


LD 


A,@ADTSK 


RST 


28H 



;Get offset into the 

;module of the TCB word 
;Get a copy of the base address 
;Put base address here 
;Now HL points at TCB address 
;Put that value in DE 
;Add this entry to task slot 
;Add this task, to be run every 266.67 msec 
;Call the @ADTSK svc 



The main program has now done its work and can exit. 



LD HL,ADDED 
LD A,@DSPLY 
RST 28H 



LD 
RST 



A,@EXIT 
28H 



; Point at a message saying what was done 

;and print it 

;Call the @DSPLY svc 

;Now exit 

;Call the @EXIT svc 



This SVC does not return. 



This part of the code removes the task from the scheduler 
tables and then attempts to recover the memory that was used 
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Sample Program F, continued 



00136 
00137 
00138 
00139 
00140 
00141 
00142 
00143 
00144 
00145 
00146 
00147 
00148 
00149 
00150 
00151 
00152 
0015 3 
00154 
00155 
00156 
00157 

0015 8 
00159 
00160 
00161 
00162 
00163 
00164 
00165 
00166 

0016 7 
00168 
00169 
00170 
00171 
00172 

0017 3 
0017 4 
00175 
00176 
0017 7 
00178 
00179 
00180 
00181 
00182 
00183 
00184 
00185 
00186 
00187 
00188 
00189 
00190 
00191 
00192 
0019 3 
00194 
00195 
00196 
00197 
00198 
00199 
00200 
00201 
00202 
00203 



by the task in high memory. If another high memory module 
was added AFTER this task was added, then the memory that 
was used by this task cannot be recovered. 



KILLIT: 



CANT: 



LD 
LD 
RST 



C 

A,@RMTSK 

28H 



;We want to remove the task in slot 
;Call the iRMTSK svc 



LD 


DE, MOD NAM 


LD 


A,@GTMOD 


RST 


28H 


JR 


NZ,CANT 



At this point, the task is no longer called by the operating 
system. Now we want to determine if we can 
reclaim the memory it was using. 

; Point at the name of the module 

;Look for a module with that name 

;Call the @GTMOD svc 

;If NZ is set, then we killed some other 

;task that was using slot 0. Oops. 

;In that case, just stop and don't do any 

;more damage. 

;Set IX to point to the module. 

;Read the current value of HIGH$ 

;to see if this is the first program in 

;high memory 

;If it is, then we can recover the space 

;Call the @HIGH$ svc 

;Move HIGH$ up by one byte 

;Take the address of our module 

;and store it here 

;Compare these 

;Are they the same? 

;No, the high memory module can't be removed 

At this point, we know it is ok to reclaim the memory used by the 
high memory task. 

;Read the end of module value out of the 

;header information 

; Update the HIGH$ value 

;Call the @HIGH$ svc 

; Point to a message saying all is well 

;and print it 

;Call the @DSPLY svc 

;Exit the main program 
;Call the @EXIT svc 

Here we will display a message saying we removed the task from 
the scheduler table, but we cannot reclaim the memory that was 
used. 



LD 


IX, HL 


LD 


B,0 


LD 


HL,0 


LD 


A,8HIGH$ 


RST 


28H 


INC 


HL 


PUSH 


IX 


POP 


DE 


XOR 


A 


SBC 


HL,DE 


JR 


NZ,CANT 



LD 


HL, (IX+2) 


LD 
LD 
RST 


B,0 

A,@HIGH$ 

28H 


LD 
LD 
RST 


HL,OK 

A,@DSPLY 

28H 


LD 
RST 


A, @ EXIT 
28H 



LD 
LD 
RST 

LD 
RST 



HL,RECLM 
A,@DSPLY 
28H 

A, @ EXIT 
28H 



;Point to the message 
;and display it 
;Call the @DSPLY svc 

;Now exit 

;Call the @EXIT svc 



; Messages 

ADDED: DEFM 'Task placed in high memory and scheduled.' 

DEFB 0DH 

OK: DEFM 'Task removed from scheduler table and memory reclaimed.' 

DEFB 0DH 

RECLM: DEFM 'Task removed from scheduler table, but memory could not 
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Sample Program F, continued 



00204 

00205 

00206 

00207 

00208 

00209 

00210 

00211 

00212 

00213 

00214 

00215 

00216 

00217 

00218 

00219 

00220 

00221 

00222 

00223 

00224 

00225 

00226 

00227 

00228 

00229 

00230 

00231 

00232 

00233 

00234 

00235 

00236 

00237 

00238 

00239 

00240 

00241 

00242 

00243 

00244 

00245 

00246 

00247 

00248 

00249 

00250 

00251 

00252 

00253 

00254 

00255 

00256 

00257 

00258 

00259 

00260 

00261 

00262 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 



DEFM 'be recovered.' 
DEFB 0DH 

The Task begins at this point. This part of the program loads 
in low memory but is relocated to a point just below HIGH$ . 

This is the Memory Header Block. This block of data allows 
the system to locate this module in memory by name, 
using the @GTMOD. svc . 



MODULE: JR 
ENDADD: DEFW 



DEFB 
MODNAM: DEFM 

MODTCB: DEFW 



DEFW 



ENTRY 




MODTCB-MODNAM 
'UPTIME' 



;Jump (relative) t 
;The highest addre 
;This value is pat 
;is relocated. Th 
; later in recover i 
;this task. 
;Number of bytes i 
;This is the name 
;used to identify 
;Actual address to 
;value is patched 
;relocated. 
;Spare system poin 



o the starting address 

ss in the program. 

ched in before the program 

is will be used 

ng the memory used by 

n the name field below, 
of the module and is 
the module. 

start execution. This 
in after the program is 



ter 



RESERVED 



This area contains data used by the task. It is addressed using 
the IX register which points to the task when it is executed. 



COUNTER: DEFW 
DATBUF: DEFS 




9 



; Count of how many times we have run 
;The date is stored here 



This is the actual task. 

On entry to the task, IX points at the Task Control Block 
which in this program is the label 'MODTCB'. All data is 
referenced by indexing from that address. 



(TCB) , 



ENTRY: 



PUSH 



IY 



;Save this register. It is not saved by 
;the Task Scheduler, and we use it. 
;Registers AF, BC, DE, and HL are saved 



LD 


HL,IX 


LD 


BC , DATB 


ADD 


HL,BC 


PUSH 


IX 


PUSH 


HL 


LD 


A,@DATE 


RST 


28H 



LD 



(HL) ,0 



Now we will read the current date. 



;Get a copy of the index pointer 
BC,DATBUF-MODTCB;Get the offset needed to access the date 
;Now we have a pointer to the date 

;Save the pointer to the start of the task 

;Save a copy of that pointer 

;Ask the system what the date is 
;Call the @DATE svc 

;Terminate the date string 

;Put pointer to the date here 

;We will use this pointer later on 

;Put the cursor on the top line, 

;specified in register HL 

;at the 41st position on the screen 

;Write the message at the position 

;Save the registers we damage 

;Save it 

;Save it 

;Get our current address 

;Call the @WHERE svc 

;Get the lengths of the instructions after 
;the SVC. This will allow the subroutine 
;to return to the correct address. 



POP 


DE 


PUSH 


DE 


LD 


HL,0028H 


CALLR 


WRITE 


PUSH 


HL 


PUSH 


BC 


PUSH 


AF 


LD 


A,@WHERE 


RST 


28H 


LD 


BC, 3+1+1+1+1+2 
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Sample Program F, continued 



+ 
+ 
+ 
+ 
+ 

00263 
00264 
00265 
00266 
00267 
00268 
00269 
00270 
00271 
00272 
00273 
00274 
00275 
00276 
00277 
00278 

0027 9 
00280 
00281 
00282 

0028 3 
00284 
00285 
00286 
00287 
00288 
00289 
002 90 
00291 
00292 
00293 
00294 
+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

00295 

00296 

00297 

00298 

00299 

00300 

00301 

00302 

00303 

00304 

00305 

00306 

00307 

00308 

00309 

00310 

00311 

00312 



ADD 


HL,BC 


POP 


AF 


POP 


BC 


EX 


(SP) ,HL 


JR 


WRITE 



WRITE: 



TSKLP: 



;Add that offset to where we are 

;Put stack back 

;Restore registers 

;Put return address on stack and restore HL 

;Jump to the subroutine 

;Note that the above was actually a macro 

;which performs a relative call. 

This part, of the task displays a count of the number of times 
the task has been executed. 

;Get the pointer to DATBUF back 
;Get the pointer to the beginning of 
;this task 

;Save the pointer to DATBUF again 
:b ;Get the offset to our data 

;area 
;Put a copy of the base address in HL 
;Add offset. Now HL points to COUNTER: 
;Put the pointer to COUNTER in IY 
;Get LSB of the counter 
;Get MSB of the counter 

; Increment the number of times we have run 
;Store the LSB of the counter 
; Store the MSB of the counter 

;Convert the count to decimal 
;Call the @HEXDEC svc 

;Get a zero 

;Terminate the count string 

Put pointer to date here 

Put the cursor on the top line, 

specified in register HL 

at the 55th position on the screen 

Write the message at the position 

Save the registers we damage 

Save it 

Save it 

Get our current address 

Call the @WHERE svc 

Get the lengths of the instructions after 

the SVC. This will allow the subroutine 

to return to the correct address. 

Add that offset to where we are 

Put stack back 

Restore registers 

Put return address on stack and restore HL 

Jump to the subroutine 

Note that the above was actually a macro 

which performs a relative call. 

Now we restore the IY register and return to the task scheduler. 



POP 


DE 


POP 


IX 


PUSH 


DE 


LD 


BC, COUNTER-MOD 


LD 


HL,IX 


ADD 


HL,BC 


LD 


IY,HL 


LD 


L, (IY) 


LD 


H, (IY+1) 


INC 


HL 


LD 


(IY) ,L 


LD 


(IY+1) ,H 


LD 


A,@HEXDEC 


RST 


28H 


XOR 


A 


LD 


(DE) ,A 


POP 


DE 


LD 


HL,0036H 


CALLR 


WRITE 


PUSH 


HL 


PUSH 


BC 


PUSH 


AF 


LD 


A,@WHERE 


RST 


28H 


LD 


BC, 3+1+1+1+1+2 


ADD 


HL,BC 


POP 


AF 


POP 


BC 


EX 


(SP) ,HL 


JR 


WRITE 



POP 
RET 



IY 



; Restore IY value 

; Return to the task scheduler 



This routine places characters on the display using the 8VDCTL 
svc instead of @DSP or @DSPLY. This allows the cursor to 
remain at its current position when we write to the screen. 
This routine must be called using the relocatable call macro 
CALLR . 



LD 
LD 



B,2 
A, (DE) 



;Put character on the display 
;Get a character to display 
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Sample Program F, continued 



00313 


OR 


A 


00314 






00315 


RET 


Z 


00316 


PUSH 


HL 


00317 


PUSH 


DE 


00318 


PUSH 


BC 


00319 


LD 


C,A 


00320 


LD 


A,@VDCTL 


00321 


RST 


28H 


00322 


POP 


BC 


00323 


POP 


DE 


00324 


POP 


HL 


00325 


INC 


L 


00326 


INC 


DE 


00327 


JR 


TSKLP 


00328 






0032 9 MOD END: END 


BEGIN 



;Is it time to stop putting this on 

;the display? 

;Yes, return to the caller 

;Save the registers, as the SVC will 

;alter the contents 

;Put the character here 

;Put character on screen at specified position 

;Call the @VDCTL svc 

;Restore registers 



,-Advance display position 

;Point to next character to display 

;Loop till date is completely displayed 

;End of task and main program 
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TRSDOS commands and utilities are covered extensively in the Disk System 
Owner's Manual. This section presents additional information of a technical 
nature on several of the commands and utilities. 



Changing the Step Rate 



The step rate is the rate at which the drive head moves from cylinder to cylinder. 
You can change the step rate for any drive by using one of the commands 
described below. 

To set the step rate for a particular drive, use the following command: 

SYSTEM (DRIVE = drive, STEP = number) 

drive is any drive enabled in the system, number can be 0, 1, 2, or 3 and rep- 
resents one of the following step rates in milliseconds: 

= 6 milliseconds 

1 = 12 milliseconds 

2 = 20 milliseconds 

3 = 30 milliseconds 

Unless it is SYSGENed, the step value you select remains in effect for the spec- 
ified drive only until the system is re-booted or turned off. If you use the 
SYSGEN command while the step value is in effect, then this step rate is written 
to the configuration file (CONFIG/SYS) on the disk in the drive specified by the 
SYSGEN command. 

On a new TRSDOS disk, the step rate is set to 12 milliseconds. 

To set the default bootstrap step rate used with the FORMAT utility, use the fol- 
lowing command: 

SYSTEM (BSTEP = number) 

number is 0, 1, 2, or 3, which correspond to 6, 12, 20, and 30 milliseconds, 
respectively. 

The value you select for number is stored in the system information sector on 
the disk in Drive 0. (On a new TRSDOS disk, the bootstrap step rate is set to 12 
milliseconds.) 

If you switch Drive disks or change the logical Drive with the SYSTEM 
(SYSTEM) command, the default value is taken off the new Drive disk if you 
format a disk. 

You can change the bootstrap step rate for a particular FORMAT operation if 
you do not want to use the default. Specify the new value for STEP on the 
FORMAT command line as follows: 

FORMAT -.drive (STEP = number) 

drive is the drive to be used for the FORMAT, number is 0, 1, 2, or 3, which cor- 
respond to 6, 12, 20, and 30 milliseconds, respectively. 

The step rate is important only if you will be using the disk in Drive to start up 
the system. Keep in mind that too low a step rate may keep the disk from 
booting. 
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'hanging the WAIT Valw 



The WAIT parameter compensates for hardware incompatibility between cer- 
tain disk drives. The only time you should use it is when all tracks above a cer- 
tain point during a FORMAT operation are shown as locked out when the 
FORMAT is verified. 

The value assigned to WAIT signifies the amount of time between the arrival of 
the drive head at the location for a read or write, and the actual start of the read 
or write. 

If you want to change the WAIT value, specify the new value on the FORMAT 
command line as follows: 

FORMAT -.drive (WAIT = number) 

number is a value between 5000 and 50000. The exact value depends on the 
particular disk drive you are using. We recommend that you use a value around 
25000 at first. Adjust this value higher if tracks are still locked out, or lower until 
the bottom limit is determined. 



LOG is a utility program that logs in the directory track, number of sides, and 
density of a diskette. The syntax is: 

LOG -.drive 

drive is any drive currently enabled in the system. 

The LOG utility provides a way to log in diskette information and update the 
drive's Drive Code Table (DCT). It performs the same log-in function as the 
DEVICE library command, except for a single drive rather than all drives. It also 
provides a way to swap the Drive diskette for a double-sided diskette. 

The LOG :0 command prompts you to switch the Drive diskette. You must use 
this command when switching between double- and single-sided diskettes in 
Drive 0. Otherwise, it is not needed. 

Example 

If you want to switch disks in Drive 0, type: 



LOG :0 (ENTER) 
The system prompts you with the message: 

Exchange disks and hit <ENTER> 

Remove t he cur rent disk from Drive and insert the new system disk. When 
you press (enter) , information about the new disk is entered to the system. 



Printing Graphics CSiarai " ■ 



If your printer is capable of directly reproducing the TRS-80 graphics charac- 
ters, you can use the SYSTEM (GRAPHIC) command. Once you have issued 
this command, any graphics characters on the screen will be sent to the line 
printer during a screen print. (Pressing (CUD© causes the contents of the 
video display to be printed on the printer.) 

Do not use this command unless your printer is capable of directly reproducing 
the TRS-80 graphics characters. 
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Changing the Clock Rate 



The system normally runs at the fast clock rate of 4 megahertz. 

A slow mode of 2 megahertz is available, and may be necessary for real time- 
dependent programs. (This slow rate is the same as the Model III clock rate.) 

To switch to the slow rate, enter the following command: 

SYSTEM (SLOW) 
To switch back to the fast rate, enter: 

SYSTEM (FAST) 
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A/TRSDOS Error Messages 



If the computer displays one of the messages listed in this appendix, an oper- 
ating system error occurred. Any other error message may refer to an applica- 
tion program error, and you should check your application program manual for 
an explanation. 

When an error message is displayed: 

• Try the operation several times. 

- Look up operating system errors below and take any recommended 
actions. (See your application program manual for explanations of appli- 
cation program errors.) 

• Try using other diskettes. 

• Reset the computer and try the operation again. 

• Check all the power connections. 

• Check all interconnections. 

- Remove all diskettes from drives, turn off the computer, wait 15 seconds, 
and turn it on again. 

• If you try all these remedies and still get an error message, contact a 
Radio Shack Service Center. 

Note: If there is more than one thing wrong, the computer might wait until you 
correct the first error before displaying the second error message. 

This list of error messages is alphabetical, with the binary and hexadecimal 
error numbers in parentheses. Following it is a quick reference list of the mes- 
sages arranged in numerical order. 

Attempted to read locked/deleted data record (Error 7, X'07') 

In a system that supports a "deleted record" data address mark, an attempt was 
made to read a deleted sector. TRSDOS currently does not use the deleted 
sector data address mark. Check for an error in your application program. 

Attempted to read system data record (Error 6, X'06') 

An attempt was made to read a directory cylinder sector without using the 
directory read routines. Directory cylinder sectors are written with a data 
address mark that differs from the data sector's data address mark. Check for 
an error in your application program. 

Data record not found during read (Error 5, X'05') 

The sector number for the read operation is not on the cylinder being refer- 
enced. Either the disk is flawed, you requested an incorrect number, or the cyl- 
inder is improperly formatted. Try the operation again. If it fails, use another 
disk. Reformatting the old disk should lock out the flaw. 

Data record not found during write (Error 13, X'0D') 

The sector number requested for the write operation cannot be found on the 
cylinder being referenced. Either the disk is flawed, you requested an incorrect 
number, or the cylinder is improperly formatted, fry the operation again. If it 
fails, use another disk. 

Device in use (Error 39, X'27') 

A request was made to REMOVE a device (delete it from the Device Control 
Block tables) while it was in use. RESET the device in use before removing it. 
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Device not available (Error 8, X'08') 

A reference was made for a logical device that cannot be found in the Device 
Control Block. Probably, your device specification was wrong or the device 
peripheral was not ready. Use the DEVICE command to display all devices 
available to the system. 

Directory full — can't extend file (Error 30, X'1 E') 

A file has all extent fields of its last directory record in use and must find a spare 
directory slot but none is available. (See the "Directory Records" section.) Copy 
the disk's files to a newly formatted diskette to reduce file fragmentation. You 
may use backup by class or backup reconstruct to reduce fragmentation. 

Directory read error (Error 17, X'1f ) 

A disk error occurred during a directory read. The problem may be media, hard- 
ware, or program failure. Move the disk to another drive and try the operation 
again. 

Directory write error (Error 18, X'12') 

A disk error occurred during a directory write to disk. The directory may no 
longer be reliable. If the problem recurs, use a different diskette. 

Disk space full (Error 27, X'1 B') 

While a file was being written, all available disk space was used. The disk con- 
tains only a partial copy of the file. Write the file to a diskette that has more avail- 
able space. Then, REMOVE the partial copy to recover disk space. 

End of file encountered (Error 28, X'1C) 

You tried to read past the end of file pointer. Use the DIR command to check the 
size of the file. This error also occurs when you use the @PEOF supervisor call 
to successfully position to the end of a file. Check for an error in your application 
program. 

Extended error (Error 63) 

An error has occurred and the extended error code is in the HL register pair. 

File access denied (Error 25, Xi9') 

You specified a password for a file that is not password protected or you spec- 
ified the wrong password for a file that is password protected. 

File already open (Error 41, X'29') 

You tried to open a file for UPDATE level or higher, and the file already is open 
with this access level or higher. This forces a change to READ access protec- 
tion. Use the RESET library command to close the file. 

File not in directory (Error 24, X'18') 

The specified filespec cannot be found in the directory. Check the spelling of 
the filespec. 

File not open (Error 38, X'26') 

You requested an I/O operation on an unopened file. Open the file before 
access. 

GAT read error (Error 20, X'14') 

A disk error occurred during the reading of the Granule Allocation Table. The 
problem may be media, hardware, or program failure. Move the diskette to 
another drive and try the operation again. 

GAT write error (Error 21, X'15') 

A disk error occurred during the writing of the Granule Allocation Table. The 
GAT may no longer be reliable. If the problem recurs, use a different drive or 
different diskette. 
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HIT read error (Error 22, X'16') 

A disk error occurred during the reading of the Hash Index Table. The problem 
may be media, hardware, or program failure. Move the diskette to another drive 
and try the operation again. 

HIT write error (Error 23, X'17') 

A disk error occurred during the writing of the Hash Index Table. The HIT may 
no longer be reliable. If the problem recurs, use a different drive or different 
diskette. 

Illegal access attempted to protected file (Error 37, X'25') 

The USER password was given for access to a file, but the requested access 
required the OWNER password. (See the ATTRIB library command in your 
Disk System Owner's Manual.) 

Illegal drive number (Error 32, X'20') 

The specified disk drive is not included in your system or is not ready for access 
(no diskette, non-TRSDOS diskette, drive door open, and so on). See the 
DEVICE command in your Disk System Owner's Manual.) 

Illegal file name (Error 19, X'13') 

The specified filespec does not meet TRSDOS filespec requirements. See your 
Disk System Owner's Manual for proper filespec syntax. 

Illegal logical file number (Error 16, X'10') 

A bad Directory Entry Code (DEC) was found in the File Control Block (FCB). 
This usually indicates that your program has altered the FCB improperly. Check 
for an error in your application program. 

Load file format error (Error 34, X'22') 

An attempt was made to load a file that cannot be loaded by the system loader. 
The file was probably a data file or a BASIC program file. 

Lost data during read (Error 3, X'03') 

During a sector read, the CPU did not accept a byte from the Floppy Disk Con- 
troller (FDC) data register in the time allotted. The byte was lost. This may indi- 
cate a hardware problem with the drive. Move the diskette to another drive and 
try again. If the error recurs, try another diskette. 

Lost data during write (Error 11, X'OB') 

During a sector write, the CPU did not transfer a byte to the Floppy Disk Con- 
troller (FDC) in the time allotted. The byte was lost; it was not transferred to the 
disk. This may indicate a hardware problem with the drive. Move the diskette to 
another drive and try again. If the error recurs, try another diskette. 

LRL open fault (Error 42, X'2A') 

The logical record length specified when the file was opened is different than 
the LRL used when the file was created. COPY the file to another file that has 
the specified LRL. 

No device space available (Error 33, X'21') 

You tried to SET a driver or filter and all of the Device Control Blocks were in 
use. Use the DEVICE command to see if any non-system devices can be 
removed to provide more space. This error also occurs on a "global" request to 
initialize a new file (that is, no drive was specified), if no file can be created. 

No directory space available (Error 26, X'1 A') 

You tried to open a new file and no space was left in the directory. Use a differ- 
ent disk or REMOVE some files that you no longer need. 



367 



No error (Error 0) 

The @ERROR supervisor call was called without any error condition being 
detected. A return code of zero indicates no error. Check for an error in your 
application program. 

Parity error during header read (Error 1, X'OT) 

During a sector I/O request, the system could not read the sector header suc- 
cessfully. If this error occurs repeatedly, the problem is probably media or hard- 
ware failure. Try the operation again, using a different drive or diskette. 

Parity error during header write (Error 9, X'09') 

During a sector write, the system could not write the sector header satisfactor- 
ily. If this error occurs repeatedly, the problem is probably media or hardware 
failure. Try the operation again, using a different drive or diskette. 

Parity error during read (Error 4, X'04') 

An error occurred during a sector read. Its probable cause is media failure or a 
dirty or faulty disk drive. Try the operation again, using a different drive or 
diskette. 

Parity error during write (Error 12, X'OC) 

An error occurred during a sector write operation. Its probable cause is media 
failure or a dirty or faulty disk drive. Try the operation again, using a different 
drive or diskette. 

Program not found (Error 31, X'1F) 

The file cannot be loaded because it is not in the directory. Either the filespec 
was misspelled or the disk that contains the file was not loaded. 

Protected system device (Error 40, X'28') 

You cannot REMOVE any of the following devices: *KI, *DO, *PR, *JL, *SI, *SO. 
If you try, you get this error message. 

Record number out of range (Error 29, X'1D') 

A request to read a record within a random access file (see the @POSN super- 
visor call) provided a record number that was beyond the end of the file. Correct 
the record number or try again using another copy of the file. 

Seek error during read (Error 2, X'02') 

During a read sector disk I/O request, the cylinder that should contain the sec- 
tor was not found within the time allotted. (The time is set by the step rate spec- 
ified in the Drive Code Table.) Either the cylinder is not formatted or it is no 
longer readable, or the step rate is too low for the hardware to respond. You can 
set an appropriate step rate using the SYSTEM library command. The problem 
may also be caused by media or hardware failure. In this case, try the operation 
again, using a different drive or diskette. 

Seek error during write (Error 10, X'OA') 

During a sector write, the cylinder that should contain the sector was not found 
within the time allotted. (The time is set by the step rate specified in the Drive 
Code Table.) Either the cylinder is not formatted or it is no longer readable, or 
the step rate is too low for the hardware to respond. You can set an appropriate 
step rate using the SYSTEM library command. The problem may also be 
caused by media or hardware failure. In this case, try the operation again, using 
a different drive or diskette. 

— Unknown error code 

The @ERROR supervisor call was called with an error number that is not 
defined. Check for an error in your application program. 
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Write fault on disk drive (Error 14, X'0E') 

An error occurred during a write operation. This probably indicates a hardware 
problem. Try a different diskette or drive. If the problem continues, contact a 
Radio Shack Service Center. 

Write protected disk (Error 15, X'0F') 

You tried to write to a drive that has a write-protected diskette or is software 
write-protected. Remove the write-protect tab, if the diskette has one. If it does 
not, use the DEVICE command to see if the drive is set as write protected. If it 
is, you can use the SYSTEM library command with the (WP = OFF) parameter 
to write enable the drive. If the problem recurs, use a different drive or different 
diskette. 



Numerical List of Error Messages 



Decimal Hex Message 

No Error 

Parity error during header read 

Seek error during read 

Lost data during read 

Parity error during read 

Data record not found during read 

Attempted to read system data record 

Attempted to read locked/deleted data record 

Device not available 

Parity error during header write 

Seek error during write 

Lost data during write 

Parity error during write 

Data record not found during write 

Write fault on disk drive 

Write protected disk 

Illegal logical file number 

Directory read error 

Directory write error 

Illegal file name 

GAT read error 

GAT write error 

HIT read error 

HIT write error 

File not in directory 

File access denied 

Full or write protected disk 

Disk space full 

End of file encountered 

Record number out of range 

Directory Full — can't extend file 

Program not found 

Illegal drive number 

No device space available 

Load file format error 

Illegal access attempted to protected file 

File not open 

Device in use 

Protected system device 

File already open 

LRL open fault 

SVC parameter error 

Extended error 

Unknown error code 
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X'00' 


1 


X'01' 


2 


X'02' 


3 


X'03' 


4 


X'04' 


5 


X'05' 


6 


X'06' 


7 


X'07" 


8 


X'08' 


9 


X'09' 


10 


X'0A' 


11 


X'0B' 


12 


X'0C 


13 


X'0D' 


14 


X'0E' 


15 


X'0F 


16 


X'10' 


17 


X'11" 


18 


X'12' 


19 


X'13' 


20 


X'14' 


21 


X'15" 


22 


X'16' 


23 


X'17* 


24 


X'18' 


25 


X'19' 


26 


X'1A' 


27 


X'1B' 


28 


X1C 


29 


X'1D" 


30 


X1E' 


31 


X'1F 


32 


X'20' 


33 


X'21' 


34 


X'22' 


37 


X'25" 


38 


X'26' 


39 


X'27' 


40 


X'28' 


41 


X'29* 


42 


X'2A' 


43 


X'2B' 


63 


X'3F 



Appendix B/Memory Map 



OPTIONAL / 

64K MEMORY ^ 32K 



64K 



BANK1 



BANK 2 



2400H 

;2600HI 

3000H 



SYSTEM BANK 



BANK0 



rWTTTrrml 



Resident operating system, system 
buffers, overlays, drivers, etc. 

Library overlay zone 



Note: 2400H to 2600H is 
reserved for possible future 
expansion of the resident 
operating system area. 



32K 



temrnrd 64K HIGH $ 



All software must observe HIGH$. 

User software which does not allow TRSDOS library commands to be executed 
during run time may use memory from 2600H to HIGH$. 

User software which allows for library commands during execution must reside 
in and use memory only between 3000H and HIGH$. 

TRSDOS provides all functions and storage through supervisor calls. No 
address or entry point below 3000H is documented by Radio Shack. 
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Appendix C/Character Codes 



Text, control functions, and graphics are represented in the computer by codes. 
The character codes range from zero through 255. 

Codes one through 31 normally represent certain control functions. For exam- 
ple, code 13 represents a carriage return or "end of line." These same codes 
also represent special characters. To display the special character that corre- 
sponds to a particular code (1-31 ), precede the code with a code zero. 

Codes 32 through 127 represent the text characters — all those letters, num- 
bers, and other characters that are commonly used to represent textual 
information. 

Codes 128 through 191, when output to the video display, represent 64 graphics 
characters. 

Codes 192 through 255, when output to the video display, represent either 
space compression codes or special characters, as determined by software. 
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ASCII Charactei 



Code 
Dec. Hex. 
00 



ASCII 
Abbrev. 
NUL 



(CTRD (@) 



Keyboard 



Video Display 
Treat next character as dis- 
playable; if in the range 1-31, 
a special character is dis- 
played (see list of special 
characters later in this 
Appendix). 



1 


01 


SOH 


(CTRLXA) 




2 


02 


STX 


(CTRLMB) 




3 


03 


ETX 


(CTRD(C) 




4 


04 


EOT 


(CTRUfD) 




5 


05 


ENQ 


(CTRL)fE) 




6 


06 


ACK 


(CTRL)fF) 




7 


07 


BEL 


(CTRU(G) 




8 


08 


BS 


CD 

(CTRL)fH) 


Backspace and erase 


9 


09 


HT 


CB 

fCTRDfl) 




10 


0A 


LF 


(CTRL)fT) 


Move cursor to start of next 
line 


11 


0B 


VT 


(it) 
(CTRUfD 




12 


0C 


FF 


(CTRD(L) 




13 


0D 


CR 


(ENTER) 

(CTRUfD 


Move cursor to start of next 
line 


14 


0E 


SO 


(CTRLXN) 


Turn cursor on 


1b 


0F 


SI 


(CTRD(O) 


Turn cursor off 


16 


10 


DLE 


(CTRLXP) 


Enable reverse video and 
set high bit routine on* 


1/ 


11 


DC1 


(CTRL)fQJ 


Set reverse video high bit 
routine off* 


13 


12 


DC2 


(CTRL)fR) 




19 


13 


DC3 


(CTRLl(S) 




20 


14 


DC4 


(CTRU(T) 




21 


15 


NAK 


(CTRL)(U) 


Swap space compression/ 
special characters 


2^ 


16 


SYN 


(CTRLXV) 


Swap special/alternate 
characters 


23 


17 


ETB 


(CTRD(W) 


Set to 40 characters per line 


24 


18 


CAN 


(SHIFT)CU 
(CTRL)fX) 


Backspace without erasing 


25 


19 


EM 


(SHIFT)CU 
(CTRL)fY) 


Advance cursor 


26 


1A 


SUB 


(SHIFT)W 
(CTRDfZ) 


Move cursor down 


27 


1B 


ESC 


(SHIFT)C±) 
(CTRDfT) 


Move cursor up 


28 


10 


FS 


(CTRLJLD 


Move cursor to upper left 
corner. Disable reverse 
video and set high bit rou- 
tine off.* Set to 80 charac- 
ters per line. 


29 


1D 


GS 


(CTRD(ENTER) 
(CTRLK . ) 


Erase line and start over 


30 


1E 


RS 


(CTRLX ; ) 


Erase to end of line 



*When the high bit routine is on, characters 128 through 191 are displayed as 
standard ASCII characters in reverse video. 
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Code ASCII 

Dec. Hex. Abbrev. Keyboard Video Display 

Erase to end of display 
(blank) 



# 
$ 
% 
& 



31 


1F VS 


(SHIFTXCLEAR) 


32 


20 SPA 


(SPACEBAR) 


33 


21 


© 


34 


22 


CD 


35 


23 


® 


36 


24 


© 


37 


25 


® 


38 


26 


® 


39 


27 


CD 


40 


28 


CD 


41 


29 


CD 


42 


2A 


© 


43 


2B 


© 


44 


2C 


Q 


45 


2D 


Q 


46 


2E 


Q 


47 


2F 


© 


48 


30 


© 


49 


31 


CD 


50 


32 


(D 


51 


33 


© 


52 


34 


® 


53 


35 


© 


54 


36 


© 


55 


37 


m 


56 


38 


© 


57 


39 


® 


58 


3A 


© 


59 


3B 


© 


60 


3C 


© 


61 


3D 


© 


62 


3E 


© 


63 


3F 


© 


64 


40 


(D 


65 


41 


(SHIFTXA) 


66 


42 


(SHIFTKB) 


67 


43 


(SHIFTXC) 


68 


44 


(SHIFTXD) 


69 


45 


(SHIFTXE) 


70 


46 


(SHIFTKF) 


71 


47 


(SHIFTXG) 


72 


48 


(SHIFTXH) 


73 


49 


(SHIFTXD 


74 


4A 


(SHIFTXJ) 


75 


4B 


(SHIFT )(K) 


76 


4C 


(SHIFTXD 


77 


4D 


(SHIFTXM) 


78 


4E 


(SHIFTXN) 


79 


4F 


(SHIFTXOJ 


80 


50 


(SHIFTXP) 


81 


51 


(SHIFTXQ) 


82 


52 


(SHIFTXR) 


83 


53 


(SHIFTXS) 


84 


54 


(SHIFTXT) 


85 


55 


(SHIFTXU) 


86 


56 


(SHIFTXV) 


87 


57 


(SHIFTXW) 


88 


58 


(SHIFTXX) 


89 


59 


(SHIFTXY) 



/ 

1 

2 
3 
4 
5 
6 
7 
8 
9 



< 

> 

? 

@ 

A 

B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

M 

N 

O 

P 

Q 

R 

S 

T 

U 

V 

W 

X 

Y 
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Code ASCII 




Dec. 


Hex. Abbrev. Keyboard 


Video Display 


90 


5A 


(SHIFTXZ) 


Z 


91 


5B 


(CLEARM . ) 


[ 


92 


5C 


(CLEARX / ) 


\ 


93 


5D 


(CLEARX . ) 


] 


94 


5E 


(CLEARX ; ) 




95 


5F 
60 


(CLEARXENTER) 


— 


96 


(SHIFTX®) 


* 


97 


61 


© 


a 


98 


62 


© 


b 


99 


63 


© 


c 


100 


64 


® 


d 


101 


65 


© 


e 


102 


66 


© 


f 


103 


67 


© 


g 


104 


68 


® 


h 


105 


69 


© 


i 


106 


6A 


® 


J 


107 


6B 


® 


k 


108 


6C 


© 


I 


109 


6D 


(JD 


m 


110 


6E 


m 


n 


111 


6F 


© 





112 


70 


© 


P 


113 


71 


© 


q 


114 


72 


© 


r 


115 


73 


© 


s 


116 


74 


© 


t 


117 


75 


© 


u 


118 


76 


® 


V 


119 


77 


m 


w 


120 


78 


® 


X 


121 


79 


® 


y 


122 


7A 


© 


z 


123 


7B 


(CLEARKSHIFTX . ) 


{ 


124 


7C 


(CLEARXSHIFTX / ) 


I 


125 


7D 


(CLEARKSHIFTX ■ ) 


} 


126 


7E 


(CLEAR)(SHIFT)( ; J 




127 


7F DEL (CLEARXSHIFTXENTER) 


± 
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Extended (non-ASCII) Character Set 



Code 
Dec. Hex. Keyboard Video Display 

128 80 (MEM) 

129 81 (FD 

(CLEAR)(CTRD (A) 

130 82 m 

(CLEAR)(CTRD (D 
131 83 (F3) 

(CLEAR)(CTRD fC) 
(CLEAR)(ETRP (D) 
(CLEAR)(CTRD (E) 
(CLEAR)(CTRD (F) 
(CLEAR)(ETRD (G) 
(ELEM](ETRD (FT) 
(CLEAffi(STRD (D 
(CLEAR)(5TRD (J) 



132 


84 


133 


85 


134 


86 


135 


87 


136 


88 


137 


89 


138 


8A 


139 


8B 


140 


8C 


141 


8D 


142 


8E 


143 


8F 


144 


90 


145 


91 


146 


92 


147 


93 


148 


94 


149 


95 


150 


96 


151 


97 


152 


98 


153 


99 


154 


9A 


155 


9B 


156 


9C 


157 


9D 


158 


9E 


159 


9F 


160 


A0 


161 


A1 


162 


A2 


163 


A3 


164 


A4 


165 


A5 


166 


A6 


167 


A7 


168 


A8 


169 


A9 


170 


AA 


171 


AB 


172 


AC 


173 


AD 


174 


AE 


175 


AF 


176 


B0 


177 


B1 


178 


B2 



X 

XJ 

(CLEAR)(CTRL) fK) § 

(cDear)(ctrD (D §: 

(CLEARlfCTRP fD < 

(CLEAR)(CTRD (N) Z 

(CLEAR)(ETRP (F) g 

(CLEAR)(C7rD (P1 o 



(SHIFD fFTl 

(CLEAR)(CTRP (Q) 

(SHIFD (F2) 



(CLEARKSHIFD W 



(CLEAR)(SPACE) 

(CLEAR)(SHIFT) (D 

(CLEAR)(SHIFf) (2) 

(CLEAR)(SHIFD (D 

(CLEAR)(lHIFTl (4) 

(CilAR)(SHIFT) (5) 

(CiJAffifSHIFT) © 

(CLEAR)(SHIFD (7) 

(CLEAR)(SHIFT) (8) 

(CUEM)(SHIFD (9) 

(CIJAR)fSHIFTl (T) 



dLEABE) 



(CLEM) (0l 

(CLEARl g) 
(CLEAR) (21 



(D 
O 



(CLEM)(CTRD (R1 2 

(SHIFD dl) 

(CLEAR)(CTRD (Sl 



(CLEAR)(CTRD (D § 

(CLEAR)(CTRD (D) §• 

(CLEAR)(CTRD (V) & 

(CUEAR)fCTRD (W) g 

(CLEAR)(CTRD (X) CO 
(CLEARXCTRD g) 
(CLEAR)(CTRD (Z) 
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Code 


Dec. 


Hex. 


179 


B3 


180 


B4 


181 


B5 


182 


B6 


183 


B7 


184 


B8 


185 


B9 


186 


BA 


187 


BB 


188 


BC 


189 


BD 


190 


BE 


191 


BF 


192 


C0 


193 


C1 


194 


C2 


195 


C3 


196 


C4 


197 


C5 


198 


C6 


199 


C7 


200 


C8 


201 


C9 


202 


CA 


203 


CB 


204 


CC 


205 


CD 


206 


CE 


207 


CF 


208 


D0 


209 


D1 


210 


D2 


211 


D3 


212 


D4 


213 


D5 


214 


D6 


215 


D7 


216 


D8 


217 


D9 


218 


DA 


219 


DB 


220 


DC 


221 


DD 


222 


DE 


223 


DF 


224 


E0 


225 


E1 


226 


E2 


227 


E3 


228 


E4 


229 


E5 


230 


E6 


231 


E7 


232 


E8 


233 


E9 


234 


EA 



Keyboard Video Display 



©HE)® c 

(CLEAR) ® a 

(CLEAR) (5) -g 

(CLEAR) ?!) r 

(ClEM) (7) 

(CLEAR) ® 

(CLEAR) ® 

(CTEAffim £ ^ 



(CLEARKSHIFD FI 



(CTEAR)(SHIFT) (1) 

(CLEAR)(SHIFT) (A) 

(CIEAR)(SHIFT) ® 

(CTEAR)(SHIFD © 

fCTEAR)(SRIFD (D) 

(CTlA® (SHIFT) ® 

(CTJA® (SHIFT) ® 

(CTlAR)(SHIFT) (g) 

(CTEAR)(SHIF7) ® 

(CTEAR)(SHIFT) (I) 

(CTEAR)(SHIFT) (J) 



'Empties the type-ahead buffer. 

*Used by Keystroke Multiply, if KSM is active. 
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o 

CC 



o-o 



Q. 

CO 



0) 
Q. 

_ Q. 
O) < 

CD CO 

CD £ 

CO ■B 



(ClEAR) (@)* 

(CLEAR) ®** 

(CLEAR) ®** 

(CLEAR) ®** 

(CTJEAffl fD)** 

(CLEAR) ®** 

(CLEARl CF)** 

(CLEAR) ©** 

(ClEAR) (H)** 

(CLEAD fD** 

(CIEARX TT 

(CLEAR) ®** 

(CLEAR) ®** g 

(CTEAR) (W)** 

(CLEAR) (W)** 

(CLEAR) ®** 

(CLEAR) ®** 

(ClEAR) ®** 

(CIeM) (R)** 

(CLMR)®** 



>< 

C 



Q. 
Q. 
< 
CO 



CO 
1_ 

B 
o 

CO 

L. 

co 



(CLEARE D** •§ 

(CLEAR) ®** ^ 

(CLEAR) ®** o 

(ClEAR) ®** Q. 

(CLEAR) ®** >g 

(CTEARX Y)** ~ 

(CLEARl fD** = 


CO 



Code 


Dec. 


Hex, 


235 


EB 


236 


EC 


237 


ED 


238 


EE 


239 


EF 


240 


F0 


241 


F1 


242 


F2 


243 


F3 


244 


F4 


245 


F5 


246 


F6 


247 


F7 


248 


F8 


249 


F9 


250 


FA 


253 


FD 


254 


FE 


255 


FF 



Keyboard Video Display 



(CUEAR)(SHIFD (Y) 
(ELEAffifSHlFD CD 



x 



(CL£AR](SHIFn (D '-o 

fCElAPDfSHlFT lCI) © 

fCLEAR)(SHIFT) D Q- 

(gLEAR)(SHlFT) (0) „ 

(CLEAR)(SHIFD (P) £ 

(CLlAR)fSHIFT) (l) c 

(CLEAR)fSHIFf) (E) £ 

(CLEAR)(SHIFT) (D & 

[5LEAffi(SHlFD (D 2 

CCLEAR)(SHIFD (D) j= 
CCLEAR)(M[FT) fV) 
(CllAff ) fSHIFT) (W) 



CO 

'o 

(ELEAffifSHlFD flO g. 

CO 



CD 
CD 
CO 
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Graphics Characters (Codes 128-191) 



— i — 

— 



yj 



, J 



E H 



cz 



_ 2 



^BpWL. 






- 






m 



-E 









- == ! F 



-_ F 



380 



Special Characters (0-31, 192-255) 



1 



10 11 12 13 14 15 



16 17 18 19 20 21 22 23 



24 25 26 27 28 29 30 31 



192 193 194 195 196 197 198 199 



200 201 202 203 204 205 206 207 
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1 



208 209 210 211 212 213 214 215 



216 217 218 219 220 221 222 223 



224 225 226 227 228 229 230 231 



232 233 234 235 236 237 238 239 



240 241 242 243 244 245 246 247 



248 249 250 251 252 253 254 255 
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Appendix D/I 



The keyboard code map shows the code that TRSDOS returns for each key, in 
each of the modes: control, shift, unshift, clear and control, clear and shift, clear 
and unshift. 

For example, pressing (CLEAR) , (SHIFT) , and CD at the same time returns the code 
X'Ai: 

A program executing under TRSDOS — for example, BASIC — may translate 
some of these codes into other values. Consult the program's documentation 
for details. 

(BREAK) Key Handling 

The (BREAK) key (X'80') is handled in different ways, depending on the settings 
Of three system functions. The table below shows what happens for each com- 
bination of settings. 



Break 
Enabled 



Break Type- 
Vector Ahead 
Set Enabled 



Y N Y If characters are in the type-ahead buffer, 

then the buffer is emptied* 

If the type-ahead buffer is empty, then a 
BREAK character (X'80') is placed in the 
buffer* 



Y N N A BREAK character (X'80') is placed in the 
__ buffer. . 

Y Y Y The type-ahead buffer is emptied of its con- 

tents (if any), and control is transferred to the 
address in the BREAK vector (see ©BREAK 
SVC).* 



Y Y N Control is transferred to the address in the 

BREAK vector (see ©BREAK SVC). 



N X X No action is taken and characters in the type- 

ahead buffer are not affected. 



*Because the (BREAK) key is checke d for more frequently than other keys on the 
keyboard, it is possible for (break) to be pressed after another key on the key- 
board and yet be detected first. 

Y means that the function is on or enabled 
N means that the function is off or disabled 
X means that the state of the function has no effect 

Break is enabled with the SYSTEM (BREAK = ON) command (this is the 

default condition). 
The break vector is set using the ©BREAK SVC (normally off). 
Type-ahead is enabled using the SYSTEM (TYPE = ON) command (this is the 

default condition). 
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JL JL A %A- Sar 4%> 



Subject 



Page Subject 



Page 



©ABORT 230 

Access 

device 191-192 

drive 193-203 

file 186 

Address decoding 15 

Adjustment, drive motor 93 

Adjustments, FDC 61 

@ADTSK 231 

Alien disk controller 194 

Alignment, disk drive 93 

Allocation 

dynamic 185 

information 194, 207 

methods of 1 85 

pre- 185 

unit of 184 

ASCII codes 374-376 

Background tasks, invoking 215-216 

@BANK 219-221, 232-233 

Bank switching 218-221 

Baud 15, 21 

Baud rate generator 1 69 

@BKSP 234 

BOOT/SYS 187 

BREAK 

detection 21 1-214, 235 

key handling 383 

©BREAK 235 

Buffering 15, 59, 69 

Byte I/O 222-224 

Carriage movement 93 

CASIN* 29 

CASOUT* 28 

Cassette circuitry 21 

Cat eyes adjustment 94 

Characters 

ASCII 374-376 

codes 373-382 

graphics 377-378, 380 

special 378-379, 381-382 

@CHNIO 236 

@CKDRV 237 

@CKEOF 238 

@CKTSK 239 

Cleaning the magnetic head 93 

Clock generation 60, 70 

Clock rate, changing 363 

©CLOSE 240 

@CMNDI 241 



@CMNDR 242 

Codes 

ASCII 374-376 

character 373-382 

error 369 

graphics 377-378, 380 

keyboard 383-384 

return 210 

special character .... 378-379, 381-382 

Compensated write data 88 

Compliance check 96 

Control chain 132 

Controller, CRT 19 

Controller, floppy disk 9 

Converting to TRSDOS Version 6 .. 209-210 

CPU board 9, 10, 11, 15 

CREATEd files 197 

Crowbar 113, 124 

CRT 10, 11 

@CTL 222-224, 243-244 

interfacing to device drivers . . . 224-226 

Current limit circuit 130 

Cylinder 

highest numbered 194 

number of 200 

position, current 194 

starting 207 

©DATE 245 

@DCINIT 246 

@DCRES 247 

@DCSTAT 248 

DEBUG 188 

©DEBUG 249 

@DECHEX 250 

Decoding, address 15 

Density, double and single .... 183, 193, 200 
Device 

access 191-192 

handling 209 

NIL 191 

Device Control Block (DCB) 191 

Device driver 189, 190, 195 

address 191 

COM 225-226 

@CTL interfacing to 224-226 

keyboard 225 

printer 225 

templates 222-224 

video 225 

Devspec 191 
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Page Subject 



Directory 

location on disk 184, 194 

primary and extended entries 1 96, 

198, 202 

record, locating a 202 

records (DIREC) 195-198 

sectors, number of 196 

Directory Entry Code (DEC) 200-201 , 

202, 206 

@DIRRD 251 

DIR/SYS 187 

@DIRWR 252 

Disk drive 9, 10, 11, 81 

Disk, diskette 81 

controller 1 94 

double-sided 193-194, 199, 200 

files 185-186 

floppy 183 

formatting 199, 200 

hard 1 84 

I/O table 195 

minimum configuration 189-190 

name 200 

organization 183-184 

single-sided 193-194, 199, 200 

space, available 184 

@DIV8 253 

@DIV16 254 

@DODIR 255-256 

Drive 

access 193-204 

address 1 94 

floppy 183, 193 

hard 184, 193 

size 193 

Drive Code Table DCT 193-195 

Drive motor adjustment 93 

Drive select 59, 70, 88 

Driver — see Device driver 

DRVSEL* 29 

@DSP 257 

@DSPLY 258 

Duty cycle 127 

End of File (EOF) 197 

Ending Record Number (ERN) 198, 207 

ENTER detection 211-214 

Environmental specs, power supply 124 

Erase gaps 85 

Error 

codes and messages 365-369 



dictionary 1 88 

©ERROR 259 

@EXIT 260 

External disk drive 81 

FDC controller 9, 10, 1 1 , 59, 

61 , 69, 72 

Feedback control, power supply 109 

@FEXT 261 

File 

access 1 86 

descriptions, TRSDOS 187-190 

modification 1 97 

File Control Block (FCB) 205 

Files 

CREATEd 197 

device driver 1 89 

filter 189 

system (/SYS). . . 187-188, 189-190, 201 

utility 189 

Filter templates 222-224 

Filters 189, 190, 222-224 

example of 224 

©FLAGS 210, 262-263 

Floppy disk data separator 72 

Flyback converter 121 

@FNAME 264 

@FSPEC 265 

Fusing, power supply 1 09, 1 1 2 

@GET 222-224, 266 

Gran, granule 

allocation information 207 

definition 1 84, 1 99 

per track 183-184, 194 

Granule Allocation Table (GAT) 

location on disk 1 84 

contents of 198-200 

Graphics 

characters, printing 362 

codes 377-378, 380 

@GTDCB 267 

@GTDCT 268 

@GTMOD 269 

Guidelines, programming 209-226 

Hash code 197, 200 

Hash Index Table (HIT) 

location on disk 1 84 

explanation of 200-201 

@HDFMT 270 

Head amplitude 96 

Head, disk drive 93 
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Subject Page 

Head positioning 84 

@HEXDEC 271 

@HEX8 272 

@HEX16 273 

@HIGH$ 274 

Hold-Up time, power supply 124 

Horizontal linearity 146 

@ICNFG, interfacing to 214-215 

I/O bus 26 

Index pulse 84, 90 

Index sector timing 95 

Index sensor 81 , 84 

@INIT 275 

Initialization configuration 

vector 214-215 

Input line terminator 91 

Interrupt tasks 216-218 

Interrupts 59, 69, 1 70 

@IPL 276 

Job Control Language (JCL) 188, 210 

Jumper options 5 

@KBD 277 

@KEY 278 

Keyboard 19 

Keyboard codes 383-384 

@KEYIN 279 

KFLAG$ 211 

Kick start latch 125 

@KITSK, interfacing to 215-216 

@KLTSK 280 

Library commands 210 

technical information on 361-363 

©LOAD 281 

Load board values, power supply 114 

@LOC 282 

@LOF 283 

LOG utility 362 

@LOGER 284 

Logic board, disk drive 91 

Logical Record Length (LRL) 197, 206 

@LOGOT 285 

Low voltage outputs 1 1 3, 1 30 

Memory address decoding 18 

Memory banks — see RAM banks 

Memory header 1 92, 209 

Memory map 18, 371 

Minimum configuration disk 189 

Modification date 197 

MODOUT 28 

Motor adjustment, disk drive 93 



Subject Page 

@MSG 286 

@MUL8 287 

@MUL16 288 

Next Record Number (NRN) 206 

NIL device 191 

NMI logic 59, 69 

@OPEN 289 

Oscillator 15 

Overlays, system 187-188, 201 

Over-Current protection 1 24 

Over- Voltage protection 109, 124, 131 

PAL circuits 15 

@PARAM 290-291 

Password 

for TRSDOS files 190 

protection levels 196,206 

©PAUSE 292 

PAUSE detection 211-214 

@PEOF 293 

Port address decoding 15 

Port bit map 18, 28, 171 

@POSN 294 

Power supplies 9, 10, 11, 

109, 112, 121 

Precompensation, write 60 

Preventive maintenance 93 

©PRINT 295 

Printer status 21 

Printing Graphics Characters 362 

Programming Guidelines 209-226 

Protection Levels 196, 206, 209 

©PRT 296 

©PUT 222-224, 297 

Radial Alignment, Head 94 

RAM 19, 20 

RAM Banks 

switching 218-221 

use of 232-233 

©RAMDIR 2998 

©RDHDR 299 

RDINSTATUS* 28 

RDNMISTATUS* 28 

©RDSEC 300 

©RDSSC 301 

©RDTRK 302 

©READ 303 

Read Data Pulse 86, 90 

Real Time Clock 21 

Record 

length 185-186, 197,206 
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logical and physical 185-186 

numbers 1 86 

processing 1 86 

spanning 185-186 

Rectifier 113 

@REMOV 304 

@RENAM 305 

Resistor Termination 83 

Restart Vectors (RSTs) 21 1 

Return Code (RC) 210 

@REW 306 

RFI Shield 9 

Ripple Specifications 1 14, 124 

@RMTSK 307 

ROM 19 

@RPTSK 308 

@RREAD 309 

RS-232 

initializing 214 

COM driver for 225-226 

RS-232 Board 9, 1 1 , 169 

@RSLCT 310 

@RSTOR 311 

@RUN 312 

@RWRIT 313 

Sample Programs 336-359 

A 337-338 

B 339-343 

C 344-350 

D 351-352 

E 353 

F 354-359 

Sectors 

per cylinder 196, 201 

per granule 183-184, 194 

@SEEK 314 

@SEEKSC 315 

©SKIP 316 

@SLCT 317 

Snubber Circuit 1 29 

©SOUND 318 

Sound Option 22 

Special Character Codes . 378-379, 381-382 

Spindle Drive 84 

Stack handling 210 

Step rate 193 

changing 361 

@STEPI 319 

Stepper motor 81 

Supervisor calls (SVCs) 



calling procedure 227 

lists of 228-229, 331-333, 334-335 

program entry and 

return conditions 227 

sample programs using 336-359 

using 227-359 

Surge limiter 1 24 

SYS files 187-188, 189-190, 201 

System 

files 187-188, 189-190, 201 

overlays 187-188, 201 

Task 

interrupt level, adding 231 

slots 216,217,231 

Task Control Block (TCB) .... 216, 217, 231 

Vector Table (TCBVT) 216,217 

Task processor, interfacing to 216-218 

@TIME 320 

Timing, CPU 15 

Track 00 Alignment 95 

Track 00 Switch 84, 90 

Trim erase 86 

TRSDOS 

converting to Version 6 209-210 

error messages and codes 365-369 

file descriptions 187-190 

technical information on 

commands and utilities 361-363 

TYPE code 205 

Under- Voltage Lockout 1 30 

@VDCTL 321-322 

@VER 323 

Version, operating system 199 

Video Controller 19 

Video Monitor 10, 145 

Visibility 196 

Voltage Controlled Oscillator 60 

Voltage Regulation 124 

@VRSEC 324 

Wait State 60, 69 

WAIT value, changing 362 

@WEOF 325 

©WHERE 326 

WRINTMASKREG* 29 

©WRITE 327 

Write Enable 86 

Write Gate 88 

Write Precompensation 60, 69, 70 

Write Protect 84, 90, 95, 193 

WRNMIMASKREG* 28 



388 



Index 



Subject Page 

@WRSEC 328 

@WRSSC 329 

@WRTRK 330 
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